Apps und Datenspeicher

Auf dieser Seite werden Agent Search-Anwendungen und -Datenspeicher beschrieben.

Mit Agent Search erstellen Sie eine Such- oder Empfehlungsanwendung und verbinden sie mit einem Datenspeicher. Ein Google Cloud -Projekt kann mehrere Apps enthalten.

Beziehung zwischen Apps und Datenspeichern

Die Beziehung zwischen Anwendungen und Datenspeichern hängt vom Anwendungstyp ab:

  • Benutzerdefinierte Suchanwendungen haben eine m:n-Beziehung zu Datenspeichern. Wenn mehrere Datenspeicher mit einer einzelnen benutzerdefinierten Such-App verbunden sind, wird dies als zusammengeführte Suche bezeichnet. Informationen zu Einschränkungen beim Verbinden einer Such-App mit mehreren Datenspeichern finden Sie unter Zusammengeführte Suche.

  • Eine Anwendung für benutzerdefinierte Empfehlungen hat eine 1:1-Verbindung zu ihrem Datenspeicher.

  • Eine Medienanwendung hat eine n:1-Beziehung zu ihrem Datenspeicher. Eine Anwendung kann nur zu genau einem Datenspeicher eine Verbindung herstellen. Ein Datenspeicher kann dagegen mit mehreren Anwendungen verbunden sein. Beispielsweise können eine Anwendung für die Mediensuche und eine Anwendung für Medienempfehlungen gleichzeitig denselben Datenspeicher nutzen.

  • Eine Anwendung zur Suche in Gesundheitsdaten hat eine n:1-Beziehung zu ihrem Datenspeicher. Eine Anwendung kann nur zu genau einem Datenspeicher eine Verbindung herstellen. Ein Datenspeicher kann dagegen mit mehreren Anwendungen verbunden sein. So können beispielsweise eine Anwendung für Patienten und eine Anwendung für Dienstleister mit demselben Datenspeicher verbunden sein.

    Beim Batch-Datenimport von Gesundheitsdaten werden die Daten in einen Datenspeicher innerhalb einer App importiert. Beim Streaming-Datenimport (Vorabversion) von Gesundheitsdaten werden die Daten in eine Entität importiert, die ein Datenspeichertyp innerhalb eines Daten-Connectors ist. Ein Daten-Connector ist auch ein Datenspeichertyp, der sich in einer Anwendung befindet.

Sobald ein Datenspeicher mit einer Anwendung verbunden ist, kann er nicht mehr getrennt werden.

Methode zum Erstellen von Apps und zur Datenaufnahme

Wie Sie eine App erstellen und Daten aufnehmen, hängt vom Datentyp ab:

  • Für Websitedaten können Sie entweder die Google Cloud Console oder die API verwenden. Wenn Sie mit der API erstellte Websitedaten verwenden möchten, müssen Sie sie in der Google Cloud Console an eine App mit aktivierten Enterprise-Funktionen anhängen.

  • Für strukturierte oder unstrukturierte Daten können Sie entweder dieGoogle Cloud Console oder die API verwenden.

  • Für Gesundheitsdaten können Sie entweder die Google Cloud Console oder die API verwenden.

Dokumente

Jeder Datenspeicher enthält mindestens einen Datensatz, der als Dokument bezeichnet wird. Die Art des Dokuments hängt vom Datentyp im Datenspeicher ab:

  • Website: Ein Dokument ist eine Webseite.

  • Strukturierte Daten: Ein Dokument ist eine Zeile in einer Tabelle oder ein JSON-Datensatz mit einem bestimmten Schema. Sie können dieses Schema selbst angeben oder Agent Search das Schema aus den aufgenommenen Daten ableiten lassen.

  • Strukturierte Daten für Medien. Ein Dokument ist eine Zeile in einer Tabelle oder ein JSON-Datensatz mit einem medienspezifischen Schema. Die Dokumente sind Datensätze, die sich auf Medieninhalte wie Videos, Nachrichtenartikel, Musikdateien und Podcasts beziehen. Ein Dokument enthält Informationen, die die Mediendatei beschreiben, mindestens: Titel, URI des Inhalts, Kategorien, Dauer und Verfügbarkeitsdatum.

  • Unstrukturierte Daten: Ein Dokument ist eine Datei in einem der folgenden Formate: TXT, PDF, HTML, DOCX, PPTX, XLSX und XLSM.

  • FHIR-Gesundheitsdaten Ein Dokument ist eine unterstützte FHIR R4-Ressource. Eine Liste der FHIR R4-Ressourcen, die von der Agentensuche unterstützt werden, finden Sie in der Referenz zum FHIR R4-Datenschema für das Gesundheitswesen.

CRUD-Vorgänge für Datenspeicher

Für strukturierte und unstrukturierte Datenspeicher unterstützt die Agentensuche CRUD-Vorgänge (Create, Read, Update, Delete) für Dokumentdaten. Sie müssen nicht den gesamten Datenspeicher löschen oder neu erstellen, um Ihre Inhalte zu aktualisieren. Sie können einzelne Datensätze während ihres gesamten Lebenszyklus verwalten.

Sie können einzelne Dokumente oder Einträge in einem Datenspeicher über die API verwalten:

  • Erstellen: Fügen Sie einem Datenspeicherzweig mit der Methode documents.create einzelne Dokumente hinzu.
  • Lesen (Abrufen und Auflisten): Rufen Sie ein bestimmtes Dokument anhand seiner ID mit der Methode documents.get ab oder listen Sie Dokumente in einem Zweig mit der Methode documents.list auf.
  • Aktualisieren: Vorhandene Dokumentfelder, Inhalte oder Metadaten mit der Methode documents.patch ändern. Sie können auch einen Upsert-Vorgang ausführen (einfügen, wenn nicht gefunden), indem Sie das Feld allowMissing auf true setzen.
  • Selektives Löschen: Löschen Sie einzelne Datensätze selektiv mit der Methode documents.delete, anstatt den gesamten Datenspeicher zu löschen.

Datenspeicher und Apps

In Agent Search gibt es verschiedene Arten von Datenspeichern. Ein Datenspeicher kann jeweils nur einen Datentyp enthalten.

Websitedaten

Ein Datenspeicher mit Websitedaten verwendet Daten, die von öffentlichen Websites indexiert wurden. Sie können eine Reihe von URL-Mustern angeben, die in Ihren Datenspeicher aufgenommen werden sollen. Die Webseiten, die den URL-Mustern entsprechen, werden als eingeschlossene Webseiten bezeichnet. Anschließend können Sie die Suche in Daten einrichten, die von den enthaltenen Webseiten gecrawlt wurden.

Sie können beispielsweise URL-Muster wie example.com/faq/* und example.com/events/* angeben und die Suche in den Daten aktivieren, die von diesen Webseiten gecrawlt wurden und dem Muster entsprechen. Diese Daten umfassen Text, mit Metadaten getaggte Bilder und andere strukturierte Daten wie meta-Tags, PageMap-Attribute und schema.org-Daten.

Sie können auch URL-Muster für Teile von Websites angeben, die Sie ausschließen möchten, z. B. example.com/events/members-only/* oder example.com/events/past-*. Ausgeschlossene URLs haben Vorrang vor eingeschlossenen URLs.

Es gibt zwei Arten von Website-Datenspeichern:

  • Einfache Websitesuche:

    • Bietet Suchfunktionen im vorhandenen Google-Suchindex für die enthaltenen Websites.
    • Keine Domainbestätigung erforderlich.

  • Erweiterte Websiteindexierung:

    • Bietet erweiterte Suchfunktionen für einen Index, der auf einer der folgenden Optionen basiert:
      • Die Inhaber der Agent Search-Anwendung können festlegen, welche Webseiten indexiert werden, indem sie Sitemaps einreichen und pflegen. Weitere Informationen finden Sie unter Webseiten mithilfe von Sitemaps indexieren und aktualisieren. So bleibt der Index ohne manuellen Eingriff aktuell.
      • Die Inhaber der Agent Search-Anwendung können eine erste Indexierung durchführen, die den Google-Suchindex widerspiegelt, und dann die Abdeckung des Index erweitern, indem sie die Websites bei Bedarf noch einmal crawlen, um sie auf dem neuesten Stand zu halten. Weitere Informationen finden Sie unter Webseiten aktualisieren. Die erweiterten Funktionen der erweiterten Websiteindexierung sind unter Erweiterte Websiteindexierung aufgeführt.
    • Inhaber von Agent Search-Datenspeichern müssen die Domains bestätigen, zu denen die enthaltenen Websites gehören. Weitere Informationen finden Sie unter Website-Domains bestätigen.
    • Bietet die Möglichkeit, dem Datenspeicherschema strukturierte Daten hinzuzufügen. Eine Website enthält unstrukturierte Daten. Sie können Ihren Webseiten jedoch strukturierte Daten in Form von meta-Tags, PageMap-Attributen und schema.org-Daten hinzufügen. Sie können diese strukturierten Daten dann verwenden, um das Datenspeicherschema zu bearbeiten, wie unter Strukturierte Daten für die erweiterte Website-Indexierung verwenden beschrieben.

Nächste Schritte

Für die Websitesuche:

Strukturierte Daten

Ein Datenspeicher mit strukturierten Daten ermöglicht semantische Suchen oder Empfehlungen auf Basis strukturierter Daten. Sie können Daten entweder aus BigQuery oder Cloud Storage importieren. Über die API können Sie strukturierte JSON-Daten auch manuell hochladen.

Sie können beispielsweise für einen Produktkatalog Ihrer E-Commerce-Plattform oder ein Ärzteverzeichnis Such- oder Empfehlungsfunktionen aktivieren.

Agent Search erkennt das Schema automatisch anhand der importierten Daten. Sie können optional auch ein Schema für Ihre Daten angeben. Dadurch wird die Qualität der Ergebnisse in der Regel verbessert.

Nächste Schritte

Für die benutzerdefinierte Suche:

Für benutzerdefinierte Empfehlungen:

Strukturierte Daten für Medien

Medienanwendungen können nur mit Mediendatenspeichern verbunden werden. Medien-Datenspeicher sind strukturierte Datenspeicher mit einem von Google definierten Schema oder mit Ihrem eigenen benutzerdefinierten Schema, das einen bestimmten Satz von fünf medienbezogenen Feldern enthält. Weitere Informationen zum Schema finden Sie unter Informationen zu Mediendokumenten und Datenspeichern.

Sie können beispielsweise Empfehlungen aktivieren, indem Sie eine App für Medienempfehlungen für einen Filmkatalog oder eine Nachrichtenseite erstellen, damit Ihre Nutzer geeignete und personalisierte Vorschläge erhalten.

Zusätzlich zu Mediendokumenten enthalten Medienspeicher auch die Nutzerereignisinformationen, mit denen die KI-Agentensuche Empfehlungen und Suchergebnisse für Ihre Nutzer anpassen kann. Nutzerereignisse sind für Medien-Apps erforderlich. Informationen zu Nutzerereignissen finden Sie unter Echtzeit-Nutzerereignisse aufzeichnen.

Nächste Schritte

Unstrukturierte Daten

Ein Datenspeicher mit unstrukturierten Daten ermöglicht semantische Suchen auf Basis von Daten wie Dokumenten und Bildern.

Datenspeicher mit unstrukturierten Daten unterstützen Dokumente in den Formaten TXT, PDF, HTML, DOCX, PPTX, XLSX und XLSM.

Für Anfragen in natürlicher Sprache liefert die Suche Ergebnisse in Form von 10 URLs und zusammengefassten Antworten. Die Dokumente müssen mit den entsprechenden Zugriffsberechtigungen in einen Cloud Storage-Bucket hochgeladen werden. So kann beispielsweise ein Finanzinstitut für seinen privaten Korpus an Finanzpublikationen oder ein Biotech-Unternehmen für sein privates Archiv medizinischer Forschung Suchen oder Empfehlungen aktivieren.

Nächste Schritte

Für die Suche:

FHIR-Gesundheitsdaten

Eine Suchanwendung für das Gesundheitswesen verwendet FHIR R4-Daten, die aus einem FHIR-Speicher der Cloud Healthcare API importiert wurden. Eine Liste der von der Agentensuche unterstützten FHIR R4-Ressourcen finden Sie in der Referenz zum FHIR R4-Datenschema für das Gesundheitswesen. Ein FHIR R4-Datenspeicher muss einige Anforderungen erfüllen, um als Datenquelle für den Agent Search-Datenspeicher verwendet werden zu können. Weitere Informationen finden Sie unter FHIR-Gesundheitsdaten für die Aufnahme vorbereiten.

Nächste Schritte

Zusammengeführte Suche

Sie können eine App für die zusammengeführte Suche erstellen, bei der mehrere Datenspeicher mit einer einzelnen benutzerdefinierten Such-App verbunden werden können. Mit dieser Funktion können Sie mit einer App in mehreren Quellen und Datentypen suchen.

Wenn Sie eine App für die zusammengeführte Suche erstellen möchten, müssen Sie beim Erstellen einer neuen benutzerdefinierten Such-App mehrere Datenspeicher auswählen. Tun Sie dies nicht, können Sie später keine weiteren Datenspeicher hinzufügen.

Wenn Sie Suchergebnisse abrufen, können Sie entweder in allen Datenspeichern suchen oder nach Ergebnissen aus einem einzelnen Datenspeicher filtern.

Es gelten folgende Einschränkungen:

  • Datenspeicher hinzufügen und entfernen:
    • Wenn Sie für eine App die zusammengeführte Suche aktivieren möchten, müssen Sie beim Erstellen der App mindestens zwei Datenspeicher verbinden.
    • Sie können einer App für die zusammengeführte Suche Datenspeicher hinzufügen oder daraus entfernen. Die App muss jedoch immer mit mindestens zwei Datenspeichern verbunden sein.
    • Wenn Sie beim Erstellen einer Such-App nur einen Datenspeicher verbinden, können Sie weder weitere Datenspeicher hinzufügen noch diesen Datenspeicher entfernen.
  • Für Website-Datenspeicher muss die erweiterte Websiteindexierung aktiviert sein, damit sie für die zusammengeführte Suche verwendet werden können. Weitere Informationen finden Sie unter Erweiterte Websiteindexierung.
  • Datenspeicher mit unstrukturierten Daten, die aus BigQuery importiert wurden, werden nicht unterstützt.
  • Die Bildersuche (mit dem Feld params mit searchType: 1) wird nicht unterstützt.
  • Die zusammengeführte Suche unterstützt für Suchanfragen die folgenden Felder:
    • boostSpec
    • contentSearchSpec
    • dataStoreSpecs
    • facetSpecs
    • filter
    • languageCode
    • offset
    • oneBoxPageSize
    • orderBy
    • query
    • pageSize
    • pageToken
    • relevanceScoreSpec
    • relevanceThreshold
    • session
    • sessionSpec
    • spellCorrectionSpec
    • userInfo
    • userPseudoId
  • Die zusammengeführte Suche unterstützt für DataStoreSpec die folgenden Felder:
    • dataStore
    • boostSpec: Wenn sowohl für SearchRequest als auch dataStoreSpecs Boost-Spezifikationen angegeben sind, werden beide auf die Suchergebnisse angewendet.
    • filter: Wenn sowohl für SearchRequest als auch dataStoreSpecs Filter angegeben sind, werden beide auf die Suchergebnisse angewendet.
  • Bei Apps für die zusammengeführte Suche werden für Bereitstellungskonfigurationen CRUD-Vorgänge (Create, Read, Update, Delete) unterstützt. In einer Bereitstellungskonfiguration können nur die folgenden Felder hinzugefügt oder aktualisiert werden:
    • boostControlIds
    • displayName
    • filterControlIds
    • genericConfig:
      • contentSearchSpec
    • name
    • solutionType
    • synonymsControlIds
  • Bei Apps für die zusammengeführte Suche werden für folgende Steuerelemente CRUD-Vorgänge unterstützt:
    • boostAction
    • synonymAction
    • filterAction
  • Pro Such-App sind maximal 50 Datenspeicher zulässig.
  • Wenn ein Datenspeicher eine Konfiguration mit kundenverwalteten Verschlüsselungsschlüsseln verwendet, müssen alle anderen Datenspeicher ebenfalls diese Konfiguration verwenden.