Erdung mit RAG prüfen

Im Rahmen Ihrer Retrieval Augmented Generation (RAG) Erfahrung mit Vertex AI Agent Builder haben, können Sie prüfen Sie die Fundierung, um festzustellen, Basis eines Textes (der sogenannte Antwortkandidat) besteht aus einer Reihe von Referenztexte (Fakten) genannt.

Die API gibt eine Gesamtbewertung von 0 bis 1 zurück, die angibt, inwiefern die Antwort mit den angegebenen Fakten übereinstimmt. Die Antwort enthält außerdem Verweise auf die Fakten, die die einzelnen Behauptungen im Antwortkandidaten stützen.

Außerdem kannst du einen Supportwert auf Anspruchsebene aktivieren, um einen Supportwert zu erhalten, der Aufschluss darüber gibt, den Antwortkandidaten.

Für eine perfekte Begründung muss jede Behauptung in der Antwortvorlage durch mindestens eine der angegebenen Fakten gestützt werden. Mit anderen Worten: Die Behauptung ergibt sich vollständig aus den Fakten. Wenn der Anspruch nur teilweise berechtigt ist, nicht als geerdet gilt. Die Behauptung „Google wurde 1975 von Larry Page und Sergey Brin gegründet“ ist beispielsweise nur teilweise richtig. Die Namen der Gründer sind korrekt, das Datum jedoch falsch. Daher wird die gesamte Behauptung als unbegründet eingestuft. In dieser Version der API zur Überprüfung der Begründung wird ein Satz als einzelne Behauptung betrachtet.

Sie können auch Anti-Zitationen als experimentelle Funktion aktivieren, um eine Widerspruchswert, der angibt, wie stark der Kandidat der Antwort widerspricht die gegebenen Fakten. Die Antwort enthält außerdem Anti-Zitate zu den widersprüchlichen Fakten für jede Behauptung.

Sie können die API „check grounding“ verwenden, um beliebigen Text zu prüfen. Es kann sich um einen von Menschen erstellten Slogan oder eine maschinell generierte Antwort handeln. Ein typischer Anwendungsfall eine von LLM generierte Antwort mit einer bestimmten Reihe von Fakten abgleichen. Die Prüfung Die Grounding API wurde entwickelt, um schnell zu sein, mit einer Latenz von weniger als 500 ms. Dank dieser Geschwindigkeit können Chatbots die API zur Überprüfung der Validierung bei jeder Inferenz aufrufen, ohne dass es zu einer erheblichen Verlangsamung kommt. Die API zur Überprüfung der Erdung kann auch Referenzen zur Unterstützung ihrer Ergebnisse bereitstellen, damit Nutzer erkennen können, welche Teile der generierten Antwort zuverlässig sind. Die API liefert auch einen Supportwert, der die Gesamtgenauigkeit der Antwort angibt. Durch das Festlegen eines Zitationsgrenzwerts können Chatbots Antworten zum Zeitpunkt der Inferenz herausfiltern, KI-Halluzinationen.

Auf dieser Seite wird beschrieben, wie Sie die Fundierung mit der API prüfen.

Hinweise

Die API „check grounding“ ist allgemein verfügbar.

Außerdem gibt es zwei experimentelle Funktionen:

• Die Funktion „Anti-Zitationen“, die den Widerspruchswert generiert.
• Die Funktion „Wert auf Anspruchsebene“, die den Supportwert pro Anspruch zurückgibt.

Wenn Sie die experimentellen Funktionen ausprobieren möchten, wenden Sie sich an Ihr Account-Management-Team bei Google und bitten Sie um Aufnahme in die Zulassungsliste.

Definition und Erklärung von Begriffen

Bevor Sie die Prüfungs-Grounding-API verwenden, sollten Sie die Eingaben und und wie Sie fundierte Fakten strukturieren, um optimale Ergebnisse zu erzielen.

Eingabedaten

Die Prüfungs-Grounding API erfordert die folgenden Eingaben in der Anfrage.

• Antwortkandidaten: Ein Antwortvorschlag kann jeder Text sein, dessen die Sie überprüfen möchten. Im Kontext von Vertex AI Search kann der Antwortkandidat beispielsweise die generierte Suchzusammenfassung sein, die eine Suchanfrage beantwortet. Die API würde dann ermitteln, wie gut die Zusammenfassung auf den eingegebenen Fakten basiert. Ein Antwortvorschlag darf maximal 1.024 Zeichen lang sein.

• Fakten: Eine Reihe von Textsegmenten, die als Referenzen für die Verankerung dienen. Für jedes Textsegment können Metadatenattribute (Schlüssel/Wert-Paare) angegeben werden. „Autor“ und „Titel“ sind beispielsweise typische Attributschlüssel.

  Der Dienst unterstützt bis zu 200 Fakten mit jeweils maximal 10.000 Zeichen.

  Google rät davon ab, eine sehr große Tatsache anzugeben, die alle zu den Informationen. Stattdessen können Sie bessere Ergebnisse erzielen, indem Sie große Fakten in kleinere Fakten aufteilen und für die kleineren Fakten geeignete Attribute angeben. Sie können beispielsweise einen großen Fakt nach Titel, Autor oder URL aufteilen und diese Informationen in Attributen angeben.

• Zitationsgrenzwert: Ein Gleitkommawert zwischen 0 und 1, der die Konfidenz für die Zitate steuert, die die Antwortvorschläge unterstützen. Höherer Grenzwert stört das Vertrauen. Ein höherer Grenzwert führt daher zu weniger, aber aussagekräftigeren Zitaten.

Ausgabedaten

Die Grounding API gibt für einen Antwortkandidaten Folgendes zurück:

• Supportwert:Der Supportwert ist eine Zahl von 0 bis 1, die Gibt an, wie fundiert eine Antwortkandidat anhand der bereitgestellten Fakten ist. Er gibt ungefähr den Anteil der Behauptungen im Antwortkandidaten an, die auf mindestens einer der angegebenen Fakten beruhen.

• Zitierte Blöcke: Zitierte Blöcke sind Teile der Eingabefakten, die die den Antwortkandidaten unterstützen.

• Ansprüche und Zitate: Die Ansprüche und Zitationen stellen eine Verbindung zu einer Behauptung her (in der Regel ein Satz) des Antwortkandidats auf einen oder mehrere der zitierten Blöcke, die die Behauptung untermauern.

  Wenn die Bewertung auf Anspruchsebene aktiviert ist, wird für jeden Anspruch eine Unterstützung wird als Zahl zwischen 0 und 1 zurückgegeben, die angibt, Behauptung ist in den bereitgestellten Fakten enthalten. Weitere Informationen finden Sie unter Erhalten Sie Bewertungen auf Anspruchsebene für ein Antwortkandidaten.

• Erdungscheck erforderlich: Bei jeder Beschwerde wird ein boolescher Wert für „grounding-check-required“ zurückgegeben. Wenn False zurückgegeben wird, bedeutet das System, dass die Behauptung keine Fundierung erfordert. Zitate und Anti-Zitationen werden daher nicht zurückgegeben. Beispiel: wie „Hier ist, was ich gefunden habe.“ keine Tatsache ist und daher erfordert keine Fundierungsprüfung.

  Wenn „grounding-check-required“ den Wert true zurückgibt, wurde eine Fundierungsüberprüfung durchgeführt und es werden gegebenenfalls Unterstützungsbewertungen, Zitate und Anti-Zitate zurückgegeben.

Supportbewertung für einen Antwortkandidaten abrufen

Folgen Sie diesen Schritte:

1. Bereiten Sie Ihre Faktensammlung vor. Weitere Informationen und Beispiele finden Sie unter Nutzungsbedingungen definiert und erklärt.

2. Rufen Sie die Methode check mit dem folgenden Code auf:

REST

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/groundingConfigs/default_grounding_config:check" \
-d '{
  "answerCandidate": "CANDIDATE",
  "facts": [
  {
    "factText": "TEXT_0",
    "attributes": {"ATTRIBUTE_A": "VALUE_A0","ATTRIBUTE_B": "VALUE_B0"}
  },
  {
    "factText": "TEXT_1",
    "attributes": {"ATTRIBUTE_A": "VALUE_A1","ATTRIBUTE_B": "VALUE_B1"}
  },
  {
    "factText": "TEXT_2",
    "attributes": {"ATTRIBUTE_A": "VALUE_A2","ATTRIBUTE_B": "VALUE_B2"}
  }
  ],
  "groundingSpec": {
    "citationThreshold": "CITATION_THRESHOLD"
  }
}'

Ersetzen Sie Folgendes:

• PROJECT_ID: die Projektnummer oder -ID Ihres Google Cloud-Projekts.

• CANDIDATE: der Antwortkandidatenstring, für den Sie möchten eine Support-Punktzahl erhalten, z. B. Titanic was directed by James Cameron. It was released in 1997.. Ein Antwortkandidat kann folgende Fragen stellen: maximal 1.024 Zeichen.

• TEXT: das zu verwendende Textsegment als Fundierung, z. B. Titanic is a 1997 American epic... Academy Awards.. Den vollständigen Text finden Sie unter Beispiele für Fakten.

• ATTRIBUTE: Der Name eines Metadatenattributs, das mit dem Fakt verknüpft ist, z. B. author oder title. Dies ist ein benutzerdefiniertes Label, mit dem dem Faktentext weitere Informationen hinzugefügt werden können. Für Beispiel: Der Faktentext Toronto is the capital of Ontario enthält author-Attribut mit seinem Wert Wikipedia, dann Folgendes: Behauptungen basieren auf Folgendem:

  • Wikipedia cites that Toronto is the capital of Ontario

  • Toronto is the capital of Ontario

    Die Behauptung, dass Government of Ontario claims that Toronto is the capital of Ontario, ist jedoch nicht so fundiert wie die ersten beiden Behauptungen.

• VALUE: der Wert für den Attribut, z. B. Simple Wikipedia oder Titanic (1997 film).

• CITATION_THRESHOLD: Ein Gleitkommawert zwischen 0 und 1, der bestimmt, ob für eine Behauptung im Antwortvorschlag eine Tatsache zitiert werden muss. Ein höherer Grenzwert führt zu weniger, aber aussagekräftigen Zitaten und ein niedrigerer Schwellenwert führt zu mehr, aber schwachen Zitaten. Ist kein Wert festgelegt, Der Standardgrenzwert ist 0.6.

Python

Weitere Informationen finden Sie in der Referenzdokumentation zur Vertex AI Agent Builder Python API.

Richten Sie Standardanmeldedaten für Anwendungen ein, um sich bei Vertex AI Agent Builder zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

from google.cloud import discoveryengine_v1alpha as discoveryengine

# TODO(developer): Uncomment these variables before running the sample.
# project_id = "YOUR_PROJECT_ID"

client = discoveryengine.GroundedGenerationServiceClient()

# The full resource name of the grounding config.
# Format: projects/{project_id}/locations/{location}/groundingConfigs/default_grounding_config
grounding_config = client.grounding_config_path(
    project=project_id,
    location="global",
    grounding_config="default_grounding_config",
)

request = discoveryengine.CheckGroundingRequest(
    grounding_config=grounding_config,
    answer_candidate="Titanic was directed by James Cameron. It was released in 1997.",
    facts=[
        discoveryengine.GroundingFact(
            fact_text=(
                "Titanic is a 1997 American epic romantic disaster movie. It was directed, written,"
                " and co-produced by James Cameron. The movie is about the 1912 sinking of the"
                " RMS Titanic. It stars Kate Winslet and Leonardo DiCaprio. The movie was released"
                " on December 19, 1997. It received positive critical reviews. The movie won 11 Academy"
                " Awards, and was nominated for fourteen total Academy Awards."
            ),
            attributes={"author": "Simple Wikipedia"},
        ),
        discoveryengine.GroundingFact(
            fact_text=(
                'James Cameron\'s "Titanic" is an epic, action-packed romance'
                "set against the ill-fated maiden voyage of the R.M.S. Titanic;"
                "the pride and joy of the White Star Line and, at the time,"
                "the largest moving object ever built. "
                'She was the most luxurious liner of her era -- the "ship of dreams" -- '
                "which ultimately carried over 1,500 people to their death in the "
                "ice cold waters of the North Atlantic in the early hours of April 15, 1912."
            ),
            attributes={"author": "Simple Wikipedia"},
        ),
    ],
    grounding_spec=discoveryengine.CheckGroundingSpec(citation_threshold=0.6),
)

response = client.check_grounding(request=request)

# Handle the response
print(response)

Beispiele für Fakten

Im Folgenden finden Sie einige Beispiele für Fakten und ihre Eigenschaften. Diese Beispiele sollen Ihnen helfen, die Fundierungsantwort und das Format des Befehls „curl“.

• Fakt 0

  • Text: "Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. The movie is about the 1912 sinking of the RMS Titanic. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards."

  • Attribute: {"Author": "Simple Wikipedia"}

• Fakt 1

  • Text: "James Cameron's "Titanic" is an epic, action-packed romance set against the ill-fated maiden voyage of the R.M.S. Titanic; the pride and joy of the White Star Line and, at the time, the largest moving object ever built. She was the most luxurious liner of her era -- the "ship of dreams" -- which ultimately carried over 1,500 people to their death in the ice cold waters of the North Atlantic in the early hours of April 15, 1912."

  • Attribute: {"Author": "Rotten Tomatoes"}

Beispielanfrage

Nachdem Sie die Fakten vorbereitet haben, können Sie die folgende Anfrage senden. Ersetzen Sie dabei das Feld CANDIDATE durch verschiedene Strings, deren Erdung Sie prüfen möchten.

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/groundingConfigs/default_grounding_config:check" \
    -d '{
    "answerCandidate": "CANDIDATE",
    "facts": [
     {
      "factText": "Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. The movie is about the 1912 sinking of the RMS Titanic. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards.",
      "attributes": {"author":"Simple Wikipedia"}
     },
     {
      "factText": "James Cameron's \"Titanic\" is an epic, action-packed romance set against the ill-fated maiden voyage of the R.M.S. Titanic; the pride and joy of the White Star Line and, at the time, the largest moving object ever built. She was the most luxurious liner of her era -- the \"ship of dreams\" -- which ultimately carried over 1,500 people to their death in the ice cold waters of the North Atlantic in the early hours of April 15, 1912.",
      "attributes": {"author":"Simple Wikipedia"}
     }
    ],
    "groundingSpec": {
      "citationThreshold": "0.6"
    }
    }'

Hinweis: Die doppelten Anführungszeichen werden mit einem umgekehrten Schrägstrich maskiert und die ein Apostroph durch seine HTML-Zeichenentität ersetzt wird.

Beispiele für Antwortvorschläge und fundierte Antworten

Die folgende Tabelle enthält Beispiele für verschiedene Antwortvorschläge und Antworten, die Sie erhalten, wenn Sie die Beispielanfrage senden, basierend auf den Beispielinformationen.

Antwortvorschlag	Erdungsantwort prüfen
Here is what I found. Titanic was directed by James Cameron.	Unterstützungsbewertung: 0.99 Zitierte Code-Chunks: [From FACT 0]....Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards..... Behauptungen und Quellenangaben: 0. Here is what I found. Fundierungsprüfung erforderlich: false 1. Titanic was directed by James Cameron. Quellenangaben: [0] Fundierungsüberprüfung erforderlich: true
Titanic was directed by James Cameron. It was released in 1997.	Supportwert: 0.99 Zitierte Blöcke: [From FACT 0]....Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards..... [From FACT 1]...Titanic is an epic, action-packed romance set against the ill-fated maiden voyage of the R.M.S. Titanic; the pride and joy of the White Star Line and, at the time, the largest moving object ever built. She was the most luxurious liner of her era which ultimately carried over 1,500 people to their death in the ice cold waters of the North Atlantic in the early hours of April 15, 1912.... Behauptungen und Quellenangaben: 0. Titanic was directed by James Cameron. Quellenangaben: [0] Fundierungsüberprüfung erforderlich: true 1. It was released in 1997. Quellenangaben: [1] Fundierungsüberprüfung erforderlich: true
Titanic was directed by James Cameron. It was based on the sinking of the RMS Titanic that led to the death of 1500 people.	Unterstützungsbewertung: 0.95 Zitierte Code-Chunks: [From FACT 0]....Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards..... [From FACT 1]...Titanic is an epic, action-packed romance set against the ill-fated maiden voyage of the R.M.S. Titanic; the pride and joy of the White Star Line and, at the time, the largest moving object ever built. She was the most luxurious liner of her era which ultimately carried over 1,500 people to their death in the ice cold waters of the North Atlantic in the early hours of April 15, 1912.... Behauptungen und Quellenangaben: 0. Cited chunks: Titanic was directed by James Cameron. Zitationen: [0] Fundierungsprüfung erforderlich: true 1. Cited chunks: It was based on the sinking of the RMS Titanic that led to the death of 1500 people. Zitate: [1] Fundierungsprüfung erforderlich: true
Titanic was directed by James Cameron. It starred Brad Pitt and Kate Winslet	Unterstützungsbewertung: 0.54 Zitierte Code-Chunks: [From FACT 0]....Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards..... [From FACT 1]...Titanic is an epic, action-packed romance set against the ill-fated maiden voyage of the R.M.S. Titanic; the pride and joy of the White Star Line and, at the time, the largest moving object ever built. She was the most luxurious liner of her era which ultimately carried over 1,500 people to their death in the ice cold waters of the North Atlantic in the early hours of April 15, 1912.... Behauptungen und Quellenangaben: 0. Titanic was directed by James Cameron. Quellenangaben: [0] Fundierungsüberprüfung erforderlich: true 1. It starred Brad Pitt and Kate Winslet Quellenangaben: [] Fundierungsüberprüfung erforderlich: true Hinweis:Auch wenn Kate Winslet in dem Film mitgespielt hat, Der Anspruch "It starred Brad Pitt and Kate Winslet" ist nicht ganz richtig, erhält sie keine Zitationen. In diesem Fall können Sie die Methode mit aktivierten Antizitaten, um einen Widerspruchswert zu erhalten. Weitere Informationen finden Sie unter Ermitteln Sie einen Widerspruchswert für Antwort möglich.

Hinweis: Die bei den API-Aufrufen eingegebenen Rohdaten sehen nicht genau so aus. Neben dem Anspruchstext gibt die Methode beispielsweise auch den Start- und die Endpositionen, an denen der Anspruchstext im Antwortvorschlag erscheint. Weitere Informationen finden Sie unter Supportbewertung für eine Antwort abrufen Kandidat.

Widerspruchswert für einen Antwortkandidat ermitteln

Experimentell

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Neben der Supportbewertung können Sie auch eine Bewertung für den Widerspruch erhalten. Der Widerspruchswert gibt ungefähr den Anteil der Behauptungen an, die den angegebenen Fakten widersprechen.

Wenn Sie diese experimentelle Funktion ausprobieren möchten, wenden Sie sich an Ihr Google Konten-Team und bitten Sie darum, auf die Zulassungsliste gesetzt zu werden.

So rufen Sie den Widerspruchswert ab:

1. Bereiten Sie Ihre Faktensammlung vor. Weitere Informationen und Beispiele finden Sie unter Nutzungsbedingungen definiert und erklärt.

2. Rufen Sie die Methode check mit dem folgenden curl-Befehl auf:

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/groundingConfigs/default_grounding_config:check" \
   -d '{
   "answerCandidate": "CANDIDATE",
   "facts": [
    {
     "factText": "TEXT_0",
     "attributes": {"ATTRIBUTE_A": "VALUE_A0","ATTRIBUTE_B": "VALUE_B0"}
    },
    {
     "factText": "TEXT_1",
     "attributes": {"ATTRIBUTE_A": "VALUE_A1","ATTRIBUTE_B": "VALUE_B1"}
    },
    {
     "factText": "TEXT_2",
     "attributes": {"ATTRIBUTE_A": "VALUE_A2","ATTRIBUTE_B": "VALUE_B2"}
    },
   ],
   "groundingSpec": {
     "citationThreshold": "CITATION_THRESHOLD",
     "enableAntiCitations": "ENABLE_ANTI_CITATION",
     "antiCitationThreshold": "ANTI_CITATION_THRESHOLD",
   }
   }'
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die Projektnummer oder -ID Ihres Google Cloud-Projekts.

   • CANDIDATE: der Antwortkandidatenstring, für den Sie möchten eine Support-Punktzahl erhalten, z. B. Titanic was directed by James Cameron. It was released in 1997.. Ein Antwortkandidat kann folgende Fragen stellen: maximal 1.024 Zeichen.

   • TEXT: Das Textsegment, das für die Begründung verwendet werden soll, z. B. Titanic is a 1997 American epic... Academy Awards.. Den vollständigen Text finden Sie unter Beispiele für Fakten.

   • ATTRIBUTE: der Name einer Metadaten Attribut, das mit der Tatsache in Verbindung steht, z. B. author oder title. Es ist ein benutzerdefiniertes Label, mit dem dem Faktentext weitere Informationen hinzugefügt werden können. Für Beispiel: Der Faktentext Toronto is the capital of Ontario enthält author-Attribut mit seinem Wert Wikipedia, dann Folgendes: Ansprüche sind begründet:

     • Wikipedia cites that Toronto is the capital of Ontario
     • Toronto is the capital of Ontario

     Die Behauptung, dass Government of Ontario claims that Toronto is the capital of Ontario, ist jedoch nicht so gut begründet.

   • VALUE: der Wert für den Attribut, z. B. Simple Wikipedia oder Titanic (1997 film).

   • CITATION_THRESHOLD: Ein Gleitkommawert zwischen 0 und 1, der bestimmt, ob für eine Behauptung im Antwortvorschlag eine Tatsache zitiert werden muss. Ein höherer Schwellenwert führt zu weniger, aber aussagekräftigen Belegen zur Unterstützung der Behauptung. Ein niedrigerer Schwellenwert führt zu mehr, aber weniger aussagekräftigen Belegen zur Unterstützung der Behauptung. Wenn der Grenzwert nicht festgelegt ist, beträgt der Standardwert 0,6.

   • ENABLE_ANTI_CITATION: ein boolescher Wert Legen Sie für dieses Feld den Wert true fest, um die experimentelle Funktion zur Bewertung des Widerspruchswerts zu aktivieren. Entfernen Sie dieses Feld oder legen Sie für dieses Feld false fest. um diese Funktion zu deaktivieren.

   • ANTI_CITATION_THRESHOLD: ein Gleitkommawert aus 0 bis 1, die bestimmt, ob eine Tatsache im Widerspruch zu einer Behauptung im Antwortkandidat. Ein höherer Grenzwert führt zu weniger, aber stärkere Zitationen, die der Behauptung widersprechen, und eine niedrigere Schwelle führt zu auf mehr, aber schwächere Zitate verweisen, die der Behauptung widersprechen. Wenn der Wert nicht festgelegt ist, beträgt der Standardgrenzwert 0,8.

Beispielanfrage

Anhand der Beispieldaten aus dem vorherigen Abschnitt können Sie die folgende Anfrage senden. Ersetzen Sie das Feld CANDIDATE durch deren Grundlagen und Widersprüche Sie überprüfen möchten.

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/groundingConfigs/default_grounding_config:check" \
    -d '{
    "answerCandidate": "CANDIDATE",
    "facts": [
     {
      "factText": "Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. The movie is about the 1912 sinking of the RMS Titanic. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards.",
      "attributes": {"author":"Simple Wikipedia"}
     },
     {
      "factText": "James Cameron's \"Titanic\" is an epic, action-packed romance set against the ill-fated maiden voyage of the R.M.S. Titanic; the pride and joy of the White Star Line and, at the time, the largest moving object ever built. She was the most luxurious liner of her era -- the \"ship of dreams\" -- which ultimately carried over 1,500 people to their death in the ice cold waters of the North Atlantic in the early hours of April 15, 1912.",
      "attributes": {"author":"Simple Wikipedia"}
     }
    ],
    "groundingSpec": {
      "citationThreshold": "0.6",
      "enableAntiCitations": true,
      "antiCitationThreshold": "0.8",
    }
    }'

Hinweis: Die doppelten Anführungszeichen werden mit dem umgekehrten Schrägstrich maskiert und das Apostroph wird durch die HTML-Zeichenentität ersetzt.

Beispiel für Antworten mit Widersprüchen

Die folgende Tabelle zeigt ein Beispiel für einen Antwortkandidaten und seine wenn Sie die Beispielanfrage senden, basierend auf den Beispielfakten.

Antwortkandidaten

Erdungsantwort prüfen

Titanic was directed by James Cameron. It starred Brad Pitt and Kate Winslet

Supportwert: 0.36 Widerspruchswert: 0.49 Zitierte Blöcke: [From FACT 0]....Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards..... [From FACT 1]...Titanic is an epic, action-packed romance set against the ill-fated maiden voyage of the R.M.S. Titanic; the pride and joy of the White Star Line and, at the time, the largest moving object ever built. She was the most luxurious liner of her era which ultimately carried over 1,500 people to their death in the ice cold waters of the North Atlantic in the early hours of April 15, 1912.... Behauptungen und Quellenangaben: 0. Titanic was directed by James Cameron. Quellen: [0] Anti-Zitate: [] Fundierungsüberprüfung erforderlich: true 1. It starred Brad Pitt and Kate Winslet Quellen: [] Anti-Zitate: [0] Fundierungsüberprüfung erforderlich: true

Hinweis: Die Roheingabe und -ausgabe der API-Aufrufe sehen nicht genau so aus. Der Span wird beispielsweise mit einem Ganzzahlbereich als Index im Antwortkandidaten angegeben. Weitere Informationen finden Sie unter Unterstützungsbewertung für einen Antwortkandidaten abrufen.

Bewertungen auf Anspruchsebene für einen Antwortkandidaten abrufen

Experimentell

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Zusätzlich zur Unterstützungsbewertung auf Antwortebene können Sie für jeden Anspruch in einem Antwortvorschlag eine Unterstützungsbewertung auf Anspruchsebene abrufen.

Wenn Sie diese experimentelle Funktion ausprobieren möchten, wenden Sie sich an Ihr Account-Management-Team bei Google und bitten Sie wurden der Zulassungsliste hinzugefügt.

So rufst du die Bewertung auf Anspruchsebene ab:

1. Bereiten Sie Ihre Fakten vor. Weitere Informationen und Beispiele finden Sie unter Nutzungsbedingungen definiert und erklärt.

2. Rufen Sie die Methode check mit dem folgenden curl-Befehl auf:

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/groundingConfigs/default_grounding_config:check" \
   -d '{
   "answerCandidate": "CANDIDATE",
   "facts": [
    {
     "factText": "TEXT_0",
     "attributes": {"ATTRIBUTE_A": "VALUE_A0","ATTRIBUTE_B": "VALUE_B0"}
    },
    {
     "factText": "TEXT_1",
     "attributes": {"ATTRIBUTE_A": "VALUE_A1","ATTRIBUTE_B": "VALUE_B1"}
    },
    {
     "factText": "TEXT_2",
     "attributes": {"ATTRIBUTE_A": "VALUE_A2","ATTRIBUTE_B": "VALUE_B2"}
    },
   ],
   "groundingSpec": {
     "citationThreshold": "CITATION_THRESHOLD",
     "enableClaimLevelScore": "ENABLE_CLAIM_LEVEL_SCORE",
   }
   }'
   

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die Projektnummer oder -ID Ihres Google Cloud-Projekts.

   • CANDIDATE: Der String für den Antwortvorschlag, für den Sie eine Unterstützungsbewertung erhalten möchten, z. B. Titanic was directed by James Cameron. It was released in 1997.. Ein Antwortvorschlag kann maximal 1.024 Zeichen lang sein.

   • TEXT: das zu verwendende Textsegment als Fundierung, z. B. Titanic is a 1997 American epic... Academy Awards.. Den vollständigen Text finden Sie unter Beispiele für Fakten.

   • ATTRIBUTE: der Name einer Metadaten Attribut, das mit der Tatsache in Verbindung steht, z. B. author oder title. Es ist ein benutzerdefiniertes Label, mit dem weitere Informationen zum Faktentext hinzugefügt werden können. Wenn der Faktentext Toronto is the capital of Ontario beispielsweise ein author-Attribut mit dem Wert Wikipedia hat, sind die folgenden Behauptungen fundiert:

     • Wikipedia cites that Toronto is the capital of Ontario
     • Toronto is the capital of Ontario

     Die Behauptung, dass Government of Ontario claims that Toronto is the capital of Ontario, ist jedoch nicht so gut begründet.

   • VALUE: der Wert für den Attribut, z. B. Simple Wikipedia oder Titanic (1997 film).

   • CITATION_THRESHOLD: ein Gleitkommawert zwischen 0 und 1 über das festgelegt wird, ob in der Antwort eine Tatsache in einer Behauptung zitiert werden muss Kandidat:innen. Ein höherer Schwellenwert führt zu weniger, aber aussagekräftigen Belegen zur Unterstützung der Behauptung. Ein niedrigerer Schwellenwert führt zu mehr, aber weniger aussagekräftigen Belegen zur Unterstützung der Behauptung. Wenn kein Wert festgelegt ist, beträgt der Standardwert 0,6.

   • ENABLE_CLAIM_LEVEL_SCORE: ein boolescher Wert Festlegen dieses Feld auf true setzen, um die Bewertungsfunktion auf Anspruchsebene zu aktivieren. Wenn Sie diese Funktion deaktivieren möchten, entfernen Sie dieses Feld oder legen Sie den Wert false fest.

Beispielanfrage

Anhand der Beispielfakten aus dem vorherigen Abschnitt können Sie senden Sie die folgende Anfrage. Ersetzen Sie das Feld CANDIDATE durch verschiedene Zeichenfolgen, deren Fundierung pro Anspruch du überprüfen möchtest.

    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/groundingConfigs/default_grounding_config:check" \
    -d '{
    "answerCandidate": "CANDIDATE",
    "facts": [
     {
      "factText": "Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. The movie is about the 1912 sinking of the RMS Titanic. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards.",
      "attributes": {"author":"Simple Wikipedia"}
     },
     {
      "factText": "James Cameron's \"Titanic\" is an epic, action-packed romance set against the ill-fated maiden voyage of the R.M.S. Titanic; the pride and joy of the White Star Line and, at the time, the largest moving object ever built. She was the most luxurious liner of her era -- the \"ship of dreams\" -- which ultimately carried over 1,500 people to their death in the ice cold waters of the North Atlantic in the early hours of April 15, 1912.",
      "attributes": {"author":"Simple Wikipedia"}
     }
    ],
    "groundingSpec": {
      "citationThreshold": "0.6",
      "enableClaimLevelScore": true,
    }
    }'

Hinweis: Die doppelten Anführungszeichen werden mit dem umgekehrten Schrägstrich maskiert und das Apostroph wird durch die HTML-Zeichenentität ersetzt.

Beispiel für Antworten mit Bewertungen auf Anspruchsebene

In der folgenden Tabelle sehen Sie ein Beispiel für einen Antwortkandidaten und die Antwort, die Sie erhalten, wenn Sie die Beispielanfrage senden, basierend auf den Beispielinformationen.

Antwortkandidaten

Erdungsantwort prüfen

Here is what I found. Titanic was directed by James Cameron. It starred Kate Winslet and Leonardo DiCaprio.

Unterstützungsbewertung: 0.99 Zitierte Code-Chunks: [From FACT 0]....Titanic is a 1997 American epic romantic disaster movie. It was directed, written, and co-produced by James Cameron. It stars Kate Winslet and Leonardo DiCaprio. The movie was released on December 19, 1997. It received positive critical reviews. The movie won 11 Academy Awards, and was nominated for fourteen total Academy Awards..... Behauptungen und Quellenangaben: 0. Here is what I found. Fundierungsprüfung erforderlich: false 1. Titanic was directed by James Cameron. Quellenangaben: [0] Fundierungsüberprüfung erforderlich: true Bewertung: 0.99 2. It starred Kate Winslet and Leonardo DiCaprio. Quellenangaben: [0] Fundierungsüberprüfung erforderlich: true Bewertung: 0.99