Automatische Vervollständigung konfigurieren

Auf dieser Seite wird die grundlegende Funktion zur automatischen Vervollständigung von Vertex AI Search beschrieben. Die automatische Vervollständigung generiert Abfragevorschläge basierend auf den ersten Zeichen, die für die Abfrage eingegeben wurden.

Die Vorschläge, die die automatische Vervollständigung generiert, variieren je nach Datentyp, der in der Such-App verwendet wird:

• Strukturierte und unstrukturierte Daten Standardmäßig werden Vorschläge basierend auf dem Inhalt der Dokumente im Datenspeicher generiert. Nach dem Dokumentimport werden standardmäßig erst dann Vorschläge für die automatische Vervollständigung angezeigt, wenn genügend Daten vorhanden sind, was in der Regel einige Tage dauert. Wenn Sie über die API automatisch vervollständigte Anfragen stellen, können Vorschläge basierend auf dem Suchverlauf oder Nutzerereignissen generiert werden.

• Websitedaten: Standardmäßig werden Vorschläge für die automatische Vervollständigung aus dem Suchverlauf generiert. Für die automatische Vervollständigung sind echte Suchanfragen erforderlich. Nach Beginn der Suchanfragen dauert es ein bis zwei Tage, bis die automatische Vervollständigung Vorschläge generiert. Vorschläge können mit dem experimentellen erweiterten Dokumentdatenmodell aus im Web gecrawlten Daten von öffentlichen Websites generiert werden.

• Gesundheitsdaten: Standardmäßig wird eine kanonische medizinische Datenquelle verwendet, um Vorschläge zur automatischen Vervollständigung für Datenspeicher für Gesundheitsdaten zu generieren.

Das Modell für Suchvorschläge bestimmt, welche Daten für die automatische Vervollständigung verwendet werden, um Vorschläge zu generieren. Es gibt vier Modelle für Suchanfragevorschläge:

• Document. Das Dokumentmodell generiert Vorschläge aus vom Nutzer importierten Dokumenten. Dieses Modell ist nicht für Websitedaten oder Gesundheitsdaten verfügbar.

• Vervollständigbare Felder Das Modell für ausfüllbare Felder schlägt Text vor, der direkt aus strukturierten Datenfeldern übernommen wird. Nur Felder, die mit completable gekennzeichnet sind, werden für Vorschläge zur automatischen Vervollständigung verwendet. Dieses Modell ist nur für strukturierte Daten verfügbar.

• Suchverlauf Das Suchverlaufsmodell generiert Vorschläge aus dem Verlauf der SearchService.search API-Aufrufe. Verwenden Sie dieses Modell nicht, wenn für die Methode servingConfigs.search keine Zugriffe verfügbar sind. Dieses Modell ist für Daten aus dem Gesundheitswesen nicht verfügbar.

• Nutzerereignis Das Modell für Nutzerereignisse generiert Vorschläge aus von Nutzern importierten Ereignissen vom Typ search. Dieses Modell ist für Daten aus dem Gesundheitswesen nicht verfügbar.

Autocomplete-Anfragen werden mit der Methode dataStores.completeQuery gesendet.

Wenn Sie kein Modell für Suchanfragevorschläge verwenden möchten, können Sie stattdessen importierte Vorschläge verwenden, die Vorschläge zur automatischen Vervollständigung basierend auf einer importierten Liste von Vorschlägen liefern. Weitere Informationen finden Sie unter Importierte Liste mit Vorschlägen für die automatische Vervollständigung verwenden.

Je nach Datentyp verfügbare Modelltypen

In der folgenden Tabelle sind die Modelltypen für Suchvorschläge aufgeführt, die für jeden Datentyp verfügbar sind.

* : Das Dokumentenschema muss title- oder description-Felder enthalten oder es müssen Felder vorhanden sein, die als title- oder description-Schlüsseleigenschaften angegeben wurden. Weitere Informationen finden Sie unter Schema für strukturierte Daten aktualisieren.

^† : Im Web gecrawlte Inhalte können nur als Datenquelle verwendet werden, wenn das experimentelle erweiterte Dokumentdatenmodell für die automatische Vervollständigung aktiviert ist. Weitere Informationen finden Sie unter Erweitertes Dokumentdatenmodell.

Wenn Sie das Standardmodell für Ihren Datentyp nicht verwenden möchten, können Sie beim Senden Ihrer Anfrage für die automatische Vervollständigung ein anderes Modell angeben. Anfragen für die automatische Vervollständigung werden mit der Methode dataStores.completeQuery gesendet. Weitere Informationen finden Sie unter API-Anleitung: Vollständiges Autocomplete-Modell auswählen.

Funktionen für die automatische Vervollständigung

Vertex AI Search unterstützt die folgenden Funktionen für die automatische Vervollständigung, um bei der Suche die hilfreichsten Vorschläge anzuzeigen:

Vorschläge für die Keyword-Option „Weitgehend passend“

Vorschläge für die Option „Anschlussrecherche“ werden anhand einer genauen Präfixübereinstimmung mit dem letzten Wort in einem Suchstring erstellt.

Angenommen, die Suchanfrage „songs with he“ wird in einer Anfrage zur automatischen Vervollständigung gesendet. Wenn die Endabgleichsfunktion aktiviert ist, wird bei der automatischen Vervollständigung möglicherweise festgestellt, dass für das vollständige Präfix „songs with he“ keine Übereinstimmungen gefunden wurden. Das letzte Wort in der Suchanfrage, „er“, hat jedoch eine genaue Präfixübereinstimmung mit „hallo welt“ und „hallo kitty“. In diesem Fall werden die Vorschläge „Lieder mit Hallo Welt“ und „Lieder mit Hello Kitty“ zurückgegeben, da es keine Vorschläge mit exakter Übereinstimmung gibt.

Mit dieser Funktion können Sie die Anzahl der leeren Vorschläge reduzieren und die Vielfalt der Vorschläge erhöhen. Das ist besonders nützlich, wenn die Datenquellen (Anzahl der Nutzerereignisse, Suchverlauf und Abdeckung des Dokumentthemas) begrenzt sind. Wenn Sie Vorschläge für die Abgleichung mit Endstücken aktivieren, kann sich die Gesamtqualität der Vorschläge jedoch verringern. Da bei der Endabgleichung nur das letzte Wort des Präfixes abgeglichen wird, sind einige der zurückgegebenen Vorschläge möglicherweise nicht sinnvoll. Bei einer Suchanfrage wie „songs with he“ wird beispielsweise ein Vorschlag für einen Tail-Match wie „songs with helpers guides“ angezeigt.

Vorschläge für die Abgleichung nach dem letzten Zeichen werden nur zurückgegeben, wenn:

1. include_tail_suggestions ist in der dataStores.completeQuery-Anfrage auf true festgelegt.

2. Für die Suchanfrage gibt es keine Vorschläge für eine vollständige Übereinstimmung mit dem Präfix.

Schutz vor Datenlecks

Die Definition von personenidentifizierbaren Informationen ist weit gefasst und sie können schwer zu erkennen sein. Daher kann Vertex AI Search nicht garantieren, dass keine personenidentifizierbaren Informationen in den Vorschlägen für die automatische Vervollständigung zurückgegeben werden.

In Vertex AI Search wird der Dienst Schutz sensibler Daten verwendet, um nach gängigen Arten von personenidentifizierbaren Informationen zu suchen und zu verhindern, dass sie als Vorschläge angezeigt werden. Wenn Ihre Datenspeicher jedoch personenidentifizierbare Informationen enthalten oder Sie die Modelle für Suchverlauf oder Vorschläge für Suchanfragen für Nutzerereignisse verwenden, lesen Sie die folgenden Informationen und ergreifen Sie die entsprechenden Maßnahmen:

1. Wenn die Arten von personenidentifizierbaren Informationen, die Sie schützen möchten, relativ standardmäßig sind, z. B. Telefonnummern und E-Mail-Adressen, sollten Sie zuerst die Vorschläge für die automatische Vervollständigung für Ihre App ausgiebig testen. Die Vertex AI Search kann nicht garantieren, dass personenidentifizierbare Informationen nicht in den Vorschlägen für die automatische Vervollständigung zurückgegeben werden.

2. Wenn bei den Tests zur automatischen Vervollständigung Datenlecks von personenidentifizierbaren Informationen entdeckt werden oder Sie bereits wissen, dass Sie nicht standardmäßige personenidentifizierbare Informationen schützen müssen (z. B. proprietäre Nutzer-IDs), passen Sie den Grenzwert für die automatische Vervollständigung und die Parameter für die Bereitstellung von Inhalten an. Weitere Informationen finden Sie unter Risiko reduzieren, dass Vorschläge mit personenidentifizierbaren Informationen zurückgegeben werden.

3. Wenn die Anpassung der Parameter nicht ausreicht, um Datenpannen zu verhindern, implementieren Sie eine eigene DLP-Lösung. Passen Sie die DLP-Lösung an die Arten von personenidentifizierbaren Informationen an, die am ehesten in Ihren Datenspeichern, Nutzerereignissen oder Suchanfragen von Nutzern zu finden sind. Sie können den Schutz sensibler Daten oder einen DLP-Dienst eines Drittanbieters verwenden. Führen Sie eine der folgenden Aktionen aus:

   • Filtern Sie personenidentifizierbare Informationen heraus, bevor Sie die Dokumente und Nutzerereignisse in Ihre Datenspeicher importieren.

   • Prüfen Sie die automatischen Vervollständigungsvorschläge, bevor sie Nutzern präsentiert werden, und blockieren Sie Vorschläge, die personenbezogene Daten enthalten.

4. Wenn Sie das Modell „Suchverlauf“ oder „Nutzerereignisse“ verwenden, fügen Sie in der Suchleiste einen Hinweis hinzu, in dem Nutzer darauf hingewiesen werden, keine personenidentifizierbaren Informationen in ihre Suchanfragen einzugeben.

5. Wenn Sie Fragen haben oder beim Blockieren personenidentifizierbarer Informationen auf bestimmte Probleme stoßen, wenden Sie sich an Ihren Customer Engineer (CE) oder Ihr Google-Kontoteam.

Autocomplete für ein Widget aktivieren oder deaktivieren

So aktivieren oder deaktivieren Sie die automatische Vervollständigung für ein Widget:

Einstellungen für die automatische Vervollständigung aktualisieren

So konfigurieren Sie die Einstellungen für die automatische Vervollständigung in der Benutzeroberfläche:

Risiko verringern, dass Vorschläge zurückgegeben werden, die personenbezogene Daten enthalten

Endnutzer haben alle Arten von personenidentifizierbaren Informationen wie Führerscheine und Telefonnummern, die sie für sich behalten sollten. Diese personenidentifizierbaren Informationen können jedoch von Nutzern in die Suchleiste eingegeben werden, die nach Ergebnissen suchen, die sich auf sie selbst beziehen.

Wenn Sie den Suchverlauf oder das Modell für Nutzerereignisse verwenden und die Wahrscheinlichkeit besteht, dass Ihre Nutzer personenidentifizierbare Informationen in die Suchleiste eingeben, können Sie die Weitergabe von personenidentifizierbaren Informationen reduzieren, indem Sie die folgenden Parameter anpassen:

• queryFrequencyThreshold: Bevor eine Suchanfrage als Vorschlag für die automatische Vervollständigung zurückgegeben werden kann, muss sie so oft eingegeben worden sein.

• numUniqueUsersThreshold: Bevor eine Suchanfrage als Vorschlag für die automatische Vervollständigung zurückgegeben werden kann, muss sie von dieser Anzahl an einzelnen Nutzern eingegeben worden sein. Ob es sich um einen einzelnen Nutzer handelt, wird anhand des Werts des Felds userPseudoId im Ereignis „Nutzer suchen“ ermittelt.

Beispiel für einen Anwendungsfall

Angenommen, Nutzer haben Kontonummern, die vertraulich behandelt werden sollten.

Wenn das Modell für Vorschläge aus dem Suchverlauf oder aus Nutzerereignissen verwendet wird, werden diese Kontonummern zusammen mit allen anderen Begriffen, nach denen Endnutzer suchen, verwendet, um Vorschläge zu generieren. Wenn also die Kontonummer YZ-46789A von Nutzer A wiederholt in die Suchleiste eingegeben wurde und Nutzer B die Kontonummer YZ-42345B hat, wird als Vorschlag für die automatische Vervollständigung möglicherweise die Kontonummer von Nutzer A zurückgegeben, wenn Nutzer B YZ-4 in die Suchleiste eingibt.

Um die Wahrscheinlichkeit dieser Art von Datenlecks zu verringern, entscheidet sich der Administrator von AI Applications, Folgendes zu tun:

• Erhöhen Sie den Wert des Parameters queryFrequencyThreshold auf 30. In diesem Fall ist es sehr unwahrscheinlich, dass eine Kontonummer so oft eingegeben wird. Beliebte Suchanfragen werden jedoch mindestens so oft eingegeben.

• Erhöhen Sie den Wert des Parameters numUniqueUsersThreshold auf 6. Der Administrator hält es für unwahrscheinlich, dass dieselbe Kontonummer in sechs Suchanfragen eingegeben wurde, die jeweils mit einer anderen userPseudoId verknüpft sind.

Prozedur

Für die automatische Vervollständigung gibt es zwei Grenzwertparameter. Diese Parameter sind in der Google Cloud -Konsole nicht verfügbar, können aber mit einem REST API-Aufruf an die Methode updateCompletionConfig festgelegt werden.

So konfigurieren Sie die Einstellungen für den automatischen Abschluss: Je nach Parameter, den Sie ändern möchten, sind die einzelnen Schritte optional.

Anmerkungen zu ausfüllbaren Feldern im Schema aktualisieren

So aktivieren Sie die automatische Vervollständigung für Felder im Schema für strukturierte Daten:

Autocomplete-Anfragen senden

In den folgenden Beispielen wird gezeigt, wie Sie Anfragen für die automatische Vervollständigung senden.

using Google.Cloud.DiscoveryEngine.V1;

public sealed partial class GeneratedCompletionServiceClientSnippets
{
    /// <summary>Snippet for CompleteQuery</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void CompleteQueryRequestObject()
    {
        // Create client
        CompletionServiceClient completionServiceClient = CompletionServiceClient.Create();
        // Initialize request argument(s)
        CompleteQueryRequest request = new CompleteQueryRequest
        {
            DataStoreAsDataStoreName = DataStoreName.FromProjectLocationDataStore("[PROJECT]", "[LOCATION]", "[DATA_STORE]"),
            Query = "",
            QueryModel = "",
            UserPseudoId = "",
            IncludeTailSuggestions = false,
        };
        // Make the request
        CompleteQueryResponse response = completionServiceClient.CompleteQuery(request);
    }
}

package main

import (
	"context"

	discoveryengine "cloud.google.com/go/discoveryengine/apiv1"
	discoveryenginepb "cloud.google.com/go/discoveryengine/apiv1/discoveryenginepb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := discoveryengine.NewCompletionClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &discoveryenginepb.CompleteQueryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/discoveryengine/apiv1/discoveryenginepb#CompleteQueryRequest.
	}
	resp, err := c.CompleteQuery(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

import com.google.cloud.discoveryengine.v1.CompleteQueryRequest;
import com.google.cloud.discoveryengine.v1.CompleteQueryResponse;
import com.google.cloud.discoveryengine.v1.CompletionServiceClient;
import com.google.cloud.discoveryengine.v1.DataStoreName;

public class SyncCompleteQuery {

  public static void main(String[] args) throws Exception {
    syncCompleteQuery();
  }

  public static void syncCompleteQuery() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
      CompleteQueryRequest request =
          CompleteQueryRequest.newBuilder()
              .setDataStore(
                  DataStoreName.ofProjectLocationDataStoreName(
                          "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
                      .toString())
              .setQuery("query107944136")
              .setQueryModel("queryModel-184930495")
              .setUserPseudoId("userPseudoId-1155274652")
              .setIncludeTailSuggestions(true)
              .build();
      CompleteQueryResponse response = completionServiceClient.completeQuery(request);
    }
  }
}

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The parent data store resource name for which the completion is
 *  performed, such as
 *  `projects/* /locations/global/collections/default_collection/dataStores/default_data_store`.
 */
// const dataStore = 'abc123'
/**
 *  Required. The typeahead input used to fetch suggestions. Maximum length is
 *  128 characters.
 */
// const query = 'abc123'
/**
 *  Specifies the autocomplete data model. This overrides any model specified
 *  in the Configuration > Autocomplete section of the Cloud console. Currently
 *  supported values:
 *  * `document` - Using suggestions generated from user-imported documents.
 *  * `search-history` - Using suggestions generated from the past history of
 *  SearchService.Search google.cloud.discoveryengine.v1.SearchService.Search 
 *  API calls. Do not use it when there is no traffic for Search API.
 *  * `user-event` - Using suggestions generated from user-imported search
 *  events.
 *  * `document-completable` - Using suggestions taken directly from
 *  user-imported document fields marked as completable.
 *  Default values:
 *  * `document` is the default model for regular dataStores.
 *  * `search-history` is the default model for site search dataStores.
 */
// const queryModel = 'abc123'
/**
 *  A unique identifier for tracking visitors. For example, this could be
 *  implemented with an HTTP cookie, which should be able to uniquely identify
 *  a visitor on a single device. This unique identifier should not change if
 *  the visitor logs in or out of the website.
 *  This field should NOT have a fixed value such as `unknown_visitor`.
 *  This should be the same identifier as
 *  UserEvent.user_pseudo_id google.cloud.discoveryengine.v1.UserEvent.user_pseudo_id 
 *  and
 *  SearchRequest.user_pseudo_id google.cloud.discoveryengine.v1.SearchRequest.user_pseudo_id.
 *  The field must be a UTF-8 encoded string with a length limit of 128
 *  characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
 */
// const userPseudoId = 'abc123'
/**
 *  Indicates if tail suggestions should be returned if there are no
 *  suggestions that match the full query. Even if set to true, if there are
 *  suggestions that match the full query, those are returned and no
 *  tail suggestions are returned.
 */
// const includeTailSuggestions = true

// Imports the Discoveryengine library
const {CompletionServiceClient} = require('@google-cloud/discoveryengine').v1;

// Instantiates a client
const discoveryengineClient = new CompletionServiceClient();

async function callCompleteQuery() {
  // Construct request
  const request = {
    dataStore,
    query,
  };

  // Run request
  const response = await discoveryengineClient.completeQuery(request);
  console.log(response);
}

callCompleteQuery();

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import discoveryengine_v1


def sample_complete_query():
    # Create a client
    client = discoveryengine_v1.CompletionServiceClient()

    # Initialize request argument(s)
    request = discoveryengine_v1.CompleteQueryRequest(
        data_store="data_store_value",
        query="query_value",
    )

    # Make the request
    response = client.complete_query(request=request)

    # Handle the response
    print(response)

require "google/cloud/discovery_engine/v1"

##
# Snippet for the complete_query call in the CompletionService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::DiscoveryEngine::V1::CompletionService::Client#complete_query.
#
def complete_query
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::DiscoveryEngine::V1::CompletionService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::DiscoveryEngine::V1::CompleteQueryRequest.new

  # Call the complete_query method.
  result = client.complete_query request

  # The returned object is of type Google::Cloud::DiscoveryEngine::V1::CompleteQueryResponse.
  p result
end

Sperrliste für die automatische Vervollständigung verwenden

Mithilfe einer Sperrliste können Sie verhindern, dass bestimmte Begriffe als automatisch vervollständigte Vorschläge angezeigt werden.

Nehmen wir beispielsweise ein Pharmaunternehmen. Wenn ein Medikament nicht mehr von der FDA zugelassen ist, aber in Dokumenten in seinem Datenspeicher erwähnt wird, kann er verhindern, dass dieses Medikament als vorgeschlagene Suchanfrage angezeigt wird. Das Unternehmen kann den Namen dieses Arzneimittels einer Sperrliste hinzufügen, damit es nicht vorgeschlagen wird.

Die folgenden Begrenzungen gelten:

• Eine Sperrliste pro Datenspeicher
• Beim Hochladen einer Sperrliste wird eine eventuell vorhandene Sperrliste für diesen Datenspeicher überschrieben.
• Bis zu 1.000 Begriffe pro Sperrliste
• Bei Begriffen wird die Groß- und Kleinschreibung nicht berücksichtigt.
• Nach dem Importieren einer Sperrliste dauert es 1 bis 2 Tage, bis sie wirksam wird.

Jeder Eintrag in der Sperrliste besteht aus einem blockPhrase und einem matchOperator:

• blockPhrase: Geben Sie einen String als Begriff für die Sperrliste ein. Bei Begriffen wird die Groß- und Kleinschreibung nicht berücksichtigt.
• matchOperator: Kann folgende Werte haben:
  • EXACT_MATCH: Verhindert, dass ein Begriff auf der Sperrliste als Suchanfrage vorgeschlagen wird.
  • CONTAINS: Verhindert, dass Vorschläge angezeigt werden, die den Begriff auf der Sperrliste enthalten.

Im folgenden Beispiel wird eine Sperrliste mit vier Einträgen gezeigt:

{
    "entries": [
        {"blockPhrase":"Oranges","matchOperator":"CONTAINS"},
        {"blockPhrase":"bAd apples","matchOperator":"EXACT_MATCH"},
        {"blockPhrase":"Cool as A Cucumber","matchOperator":"EXACT_MATCH"},
        {"blockPhrase":"cherry pick","matchOperator":"CONTAINS"}
    ]
}

Bevor Sie eine Sperrliste importieren, prüfen Sie, ob die erforderlichen Zugriffssteuerungen für den Editorzugriff auf die Discovery Engine festgelegt sind.

Sperrlisten können entweder aus lokalen JSON-Daten oder aus Cloud Storage importiert werden. Wenn Sie eine Sperrliste aus einem Datenspeicher entfernen möchten, entfernen Sie sie dauerhaft.

Eine Sperrliste aus lokalen JSON-Daten importieren

So importieren Sie eine Sperrliste aus einer lokalen JSON-Datei, die Ihre Sperrliste enthält:

1. Erstellen Sie die Sperrliste in einer lokalen JSON-Datei im folgenden Format. Achten Sie darauf, dass sich jeder Eintrag in der Sperrliste in einer neuen Zeile ohne Zeilenumbrüche befindet.

   {
       "inlineSource": {
           "entries": [
               { "blockPhrase":"TERM_1","matchOperator":"MATCH_OPERATOR_1" },
               { "blockPhrase":"TERM_2","matchOperator":"MATCH_OPERATOR_2" }
           ]
       }
   }

2. Stellen Sie eine POST-Anfrage an die Methode suggestionDenyListEntries:import und geben Sie dabei den Namen Ihrer JSON-Datei an.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json; charset=utf-8" \
       --data @DENYLIST_FILE \
     "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/suggestionDenyListEntries:import"
   

   Ersetzen Sie Folgendes:

   • DENYLIST_FILE: der lokale Pfad der JSON-Datei mit den Begriffen auf der Sperrliste

   • PROJECT_ID: die Nummer oder ID Ihres Google Cloud Projekts.

   • DATA_STORE_ID: die ID des Datenspeichers, der mit Ihrer App verknüpft ist.

Nach dem Importieren der Sperrliste dauert es 1–2 Tage, bis Vorschläge gefiltert werden.

Sperrliste aus Cloud Storage importieren

So importieren Sie eine Sperrliste aus einer JSON-Datei in Cloud Storage:

1. Erstellen Sie die Sperrliste in einer JSON-Datei im folgenden Format und importieren Sie sie in einen Cloud Storage-Bucket. Jeder Eintrag in der Sperrliste muss sich in einer neuen Zeile ohne Zeilenumbruch befinden.

   { "blockPhrase":"TERM_1","matchOperator":"MATCH_OPERATOR_1" }
   { "blockPhrase":"TERM_2","matchOperator":"MATCH_OPERATOR_2" }

2. Erstellen Sie eine lokale JSON-Datei mit dem gcsSource-Objekt. Verwenden Sie diesen Parameter, um auf den Speicherort der Sperrlistendatei in einem Cloud Storage-Bucket zu verweisen.

   {
       "gcsSource": {
           "inputUris": [ "DENYLIST_STORAGE_LOCATION" ]
       }
   }

   Ersetzen Sie DENYLIST_STORAGE_LOCATION durch den Speicherort Ihrer Sperrliste in Cloud Storage. Sie können nur eine URI eingeben. Der URI muss in folgendem Format eingegeben werden: gs://BUCKET/FILE_PATH.

3. Stellen Sie eine POST-Anfrage an die Methode suggestionDenyListEntries:import, einschließlich des Objekts gcsSource.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json; charset=utf-8" \
       --data @GCS_SOURCE_FILE \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/suggestionDenyListEntries:import"
   

   Ersetzen Sie Folgendes:

   • GCS_SOURCE_FILE: der lokale Pfad der Datei, die das gcsSource-Objekt enthält, das auf Ihre Sperrliste verweist.

   • PROJECT_ID: die Nummer oder ID Ihres Google Cloud Projekts.

   • DATA_STORE_ID: die ID des Datenspeichers, der mit Ihrer App verknüpft ist.

Nach dem Importieren der Sperrliste dauert es 1–2 Tage, bis Vorschläge gefiltert werden.

Sperrliste löschen

So entfernen Sie eine Sperrliste aus Ihrem Datenspeicher:

1. Stellen Sie eine POST-Anfrage an die Methode suggestionDenyListEntries:purge.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/suggestionDenyListEntries:purge"
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die Nummer oder ID Ihres Google Cloud Projekts.

   • DATA_STORE_ID: die ID des Datenspeichers, der mit Ihrer App verknüpft ist.

Importierte Liste mit Vorschlägen für die automatische Vervollständigung verwenden

Sie können eine eigene Liste mit Vorschlägen für die automatische Vervollständigung angeben, anstatt Vorschläge zu verwenden, die aus einem Datenmodell für die automatische Vervollständigung generiert wurden.

Bei den meisten Anwendungen erzielen Sie bessere Ergebnisse, wenn Sie generierte Vorschläge aus einem der Datenmodelle für die automatische Vervollständigung verwenden. Es kann jedoch in seltenen Fällen vorkommen, dass die Vorschläge des Modells nicht Ihren Anforderungen entsprechen. In diesem Fall bietet eine Liste mit Vorschlägen eine bessere Vervollständigung für Ihre Nutzer.

Eine kleine Onlinebuchhandlung importiert beispielsweise ihre Liste mit Buchtiteln als Vorschläge für die automatische Vervollständigung. Wenn ein Kunde in die Suchleiste tippt, ist der Vorschlag für die automatische Vervollständigung immer ein Buchtitel aus der importierten Liste. Wenn sich die Buchliste ändert, löscht der Buchladen die aktuelle Liste und importiert die neue Liste. Ein Auszug aus der Liste könnte so aussehen:

{"suggestion": "Wuthering Heights", "globalScore": "0.52" },
{"suggestion": "The Time Machine", "globalScore": "0.26" },
{"suggestion": "Nicholas Nickleby", "globalScore": "0.38" },
{"suggestion": "A Little Princess", "globalScore": "0.71" },
{"suggestion": "The Scarlet Letter", "globalScore": "0.32" }

globalScore ist eine Gleitkommazahl im Bereich [0, 1], mit der der Vorschlag bewertet wird. Alternativ können Sie eine frequency-Bewertung verwenden, die eine ganze Zahl größer als 1 ist. Der Wert frequency wird verwendet, um Vorschläge zu bewerten, wenn der Wert globalScore nicht verfügbar ist (als „null“ festgelegt).

Vorschläge für die automatische Vervollständigung einrichten und importieren

So richten Sie eine Liste mit Vorschlägen für die automatische Vervollständigung ein und importieren sie aus BigQuery:

1. Erstellen Sie eine Liste mit Vorschlägen und laden Sie sie in eine BigQuery-Tabelle.

   Sie müssen für jeden Vorschlag mindestens einen String und entweder eine globale Bewertung oder eine Häufigkeit angeben.

   Verwenden Sie für Ihre Liste der Vorschläge das folgende Tabellenschema:

   [
     {
       "description": "The suggestion text",
       "mode": "REQUIRED",
       "name": "suggestion",
       "type": "STRING"
     },
     {
       "description": "Global score of this suggestion. Control how this suggestion would be scored and ranked. Set global score or frequency; not both.",
       "mode": "NULLABLE",
       "name": "globalScore",
       "type": "FLOAT"
     },
     {
       "description": "Frequency of this suggestion. Used to rank suggestions when the global score is not available.",
       "mode": "NULLABLE",
       "name": "frequency",
       "type": "INTEGER"
     }
   ]
   

   In der BigQuery-Dokumentation finden Sie eine Anleitung zum Erstellen einer BigQuery-Tabelle und zum Laden der Tabelle mit Ihrer Liste der Vorschläge für die automatische Vervollständigung.

2. Importieren Sie die Liste aus BigQuery.

   Stellen Sie eine POST-Anfrage an die Methode completionSuggestions:import, einschließlich des bigquerySource-Objekts.

   curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -H "X-Goog-User-Project: PROJECT_ID" \
    "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/completionSuggestions:import" \
    -d '{
         "bigquery_source": {"project_id": "PROJECT_ID_SOURCE", "dataset_id": "DATASET_ID", "table_id": "TABLE_ID"}
    }'
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die Nummer oder ID Ihres Google Cloud Projekts.
   • DATA_STORE_ID: die ID des Vertex AI Search-Datenspeichers.
   • PROJECT_ID_SOURCE: Das Projekt, das das Dataset enthält, das Sie importieren möchten.
   • DATASET_ID: die Dataset-ID für die Vorschlagsliste, die Sie importieren möchten
   • TABLE_ID: die Tabellen-ID der Vorschlagsliste, die Sie importieren möchten

   Beispielbefehl und -ergebnis

   curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -H "X-Goog-User-Project: my-project-123" \
    "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/dataStores/my-data-store/completionSuggestions:import" \
    -d '{
   "bigquery_source": {"project_id": "my-project-123", "dataset_id": "autocomplete", "table_id": "import_suggestion2"}
   }'
       
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/operations/import-completion-suggestion-7659310803143180509",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.ImportCompletionSuggestionsMetadata"
     }
   }
   

3. Optional: Notieren Sie sich den zurückgegebenen name-Wert und folgen Sie der Anleitung unter Details zu einem lang andauernden Vorgang abrufen, um zu sehen, wann der Importvorgang abgeschlossen ist.

4. Wenn Sie die automatische Vervollständigung für die App nicht aktiviert haben, folgen Sie der Anleitung unter Einstellungen für die automatische Vervollständigung aktualisieren. Achten Sie darauf, dass Sie Automatische Vervollständigung aktivieren auf Jetzt festlegen.

5. Warten Sie einige Tage, bis die Indexierung abgeschlossen ist und die importierten Vorschläge verfügbar sind.

Autocomplete-Anfrage senden

So senden Sie eine automatische Vervollständigungsanfrage, die einen importierten Vorschlag anstelle eines Vorschlags aus einem automatischen Vervollständigungsmodell zurückgibt:

1. Folgen Sie der Anleitung, um eine automatische Vervollständigungsanfrage an ein anderes Modell zu senden, und setzen Sie AUTOCOMPLETE_MODEL auf imported-suggestion.

   Beispielbefehl und -ergebnis

   curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "X-Goog-User-Project: my-project-123" \
       "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store:completeQuery?query=t&query_model=imported-suggestion"
       
   
   Response:
   {
     "querySuggestions": [
       {
         "suggestion": "The Time Machine"
       },
       {
         "suggestion": "The Scarlet Letter"
       }
     ]
   }
   

Liste der importierten Vorschläge für die automatische Vervollständigung löschen

Entfernen Sie die vorhandene Liste, bevor Sie eine neue Liste mit Vorschlägen für die automatische Vervollständigung importieren.

So löschen Sie eine vorhandene Liste mit Vorschlägen für die automatische Vervollständigung:

1. Stellen Sie eine POST-Anfrage an die Methode completionSuggestions:purge.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/dataStores/DATA_STORE_ID/completionSuggestions:purge"
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die Nummer oder ID Ihres Google Cloud Projekts.

   • DATA_STORE_ID: die ID des Datenspeichers, der mit Ihrer App verknüpft ist.

   Beispielbefehl und -ergebnis

   curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -H "X-Goog-User-Project: my-project-123" \
    "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/dataStores/my-data-store/completionSuggestions:purge"
       
   
   {
     "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/operations/purge-customer-imported_suggestions-3197526711414652502",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.PurgeCompletionSuggestionsMetadata",
       "createTime": "2024-06-27T17:07:09.551726728Z",
       "updateTime": "2024-06-27T17:07:09.551726728Z"
     },
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.PurgeCompletionSuggestionsResponse",
       "purgeSucceeded": true
     }
   }
   

Erweitertes Datenmodell für Dokumente

KI-Anwendungen bieten ein erweitertes Datenmodell für die automatische Vervollständigung. Dieses Datenmodell generiert anhand der von Ihnen importierten Dokumente hochwertige Vorschläge für die automatische Vervollständigung, indem es Large Language Models (LLMs) von Google nutzt.

Diese Funktion wird derzeit noch getestet. Wenn Sie diese Funktion verwenden möchten, wenden Sie sich an Ihr Google Cloud Account-Management-Team und bitten Sie darum, auf die Zulassungsliste gesetzt zu werden.

Das erweiterte Dokumentendatenmodell ist nicht für die Healthcare-Suche oder in den Mehrfachregionen USA und EU verfügbar.