- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- GroundingPassages
- GroundingPassage
- SemanticRetrieverConfig
- AnswerStyle
- InputFeedback
- BlockReason
Generiert eine fundierte Antwort aus dem Modell anhand einer Eingabe-GenerateAnswerRequest
.
HTTP-Anfrage
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateAnswer
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameters | |
---|---|
model |
Erforderlich. Der Name des Format: |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{ "contents": [ { object ( |
Felder | |
---|---|
contents[] |
Erforderlich. Der Inhalt der aktuellen Unterhaltung mit dem Modell. Für Abfragen mit einer einzigen Antwort ist nur eine einzige Frage zu beantworten. Bei Abfragen mit mehreren Antworten ist dies ein wiederkehrendes Feld, das den Unterhaltungsverlauf und das letzte Hinweis: model.generateAnswer unterstützt derzeit nur Anfragen auf Englisch. |
answerStyle |
Erforderlich. Stil, mit dem Antworten zurückgegeben werden sollen. |
safetySettings[] |
Optional. Eine Liste eindeutiger Diese Änderung wird für |
Union-Feld grounding_source . Die Quellen, auf denen die Antwort begründet werden soll. Für grounding_source ist nur einer der folgenden Werte zulässig: |
|
inlinePassages |
Passagen, die inline mit der Anfrage angegeben werden. |
semanticRetriever |
Inhalte, die aus Ressourcen abgerufen wurden, die mit der Semantic Retriever API erstellt wurden. |
temperature |
Optional. Steuert die Zufälligkeit der Ausgabe. Die Werte können zwischen [0,0,1,0] (einschließlich) liegen. Ein Wert, der näher an 1,0 liegt, führt zu vielfältigeren und kreativen Antworten, während ein Wert näher an 0,0 in der Regel zu einfacheren Antworten des Modells führt. Eine niedrige Temperatur (ca.0,2) wird normalerweise für Anwendungsfälle mit zugeordneten Fragen empfohlen. |
Antworttext
Antwort des Modells für eine fundierte Antwort.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{ "answer": { object ( |
Felder | |
---|---|
answer |
Kandidatenantwort anhand des Modells. Hinweis: Das Modell versucht immer, eine fundierte Antwort zu geben, auch wenn es unwahrscheinlich ist, dass die Antwort anhand der gegebenen Absätze beantwortet werden kann. In diesem Fall können Sie eine minderwertige oder unbegründete Antwort und eine niedrige |
answerableProbability |
Nur Ausgabe Die Schätzung des Modells zur Wahrscheinlichkeit, dass seine Antwort richtig ist und auf den Eingabeabschnitten basiert. Eine niedrige answerableProbability bedeutet, dass die Antwort möglicherweise nicht auf den Quellen beruht. Wenn der
|
inputFeedback |
Nur Ausgabe Feedback zu den Eingabedaten, die zur Beantwortung der Frage verwendet wurden, im Gegensatz zu einer von einem Modell generierten Antwort auf die Frage. Bei „Eingabedaten“ kann es sich um einen oder mehrere der folgenden Werte handeln:
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/generative-language
https://www.googleapis.com/auth/generative-language.retriever
https://www.googleapis.com/auth/generative-language.retriever.readonly
https://www.googleapis.com/auth/generative-language.tuning
https://www.googleapis.com/auth/generative-language.tuning.readonly
Weitere Informationen finden Sie in der Authentifizierungsübersicht.
GroundingPassages
Eine wiederholte Liste von Passagen.
JSON-Darstellung |
---|
{
"passages": [
{
object ( |
Felder | |
---|---|
passages[] |
Liste mit Textabschnitten. |
GroundingPassage
Passage in einer Erdungskonfiguration enthalten.
JSON-Darstellung |
---|
{
"id": string,
"content": {
object ( |
Felder | |
---|---|
id |
ID für den Abschnitt, mit dem dieser Abschnitt bei begründeten Antworten zugeordnet wird. |
content |
Inhalt des Abschnitts. |
SemanticRetrieverConfig
Konfiguration zum Abrufen von Grounding-Inhalten aus einem Corpus
oder Document
, der mit der Semantic Retriever API erstellt wurde.
JSON-Darstellung |
---|
{ "source": string, "query": { object ( |
Felder | |
---|---|
source |
Erforderlich. Name der abzurufenden Ressource, z.B. corpora/123 oder corpora/123/documents/abc. |
query |
Erforderlich. Abfrage, die für Ähnlichkeitsabgleiche |
metadataFilters[] |
Optional. Filter zur Auswahl von |
maxChunksCount |
Optional. Maximale Anzahl der abzurufenden relevanten |
minimumRelevanceScore |
Optional. Minimaler Relevanzwert für abgerufene relevante |
AnswerStyle
Stil für begründete Antworten.
Enums | |
---|---|
ANSWER_STYLE_UNSPECIFIED |
Antwortstil nicht angegeben. |
ABSTRACTIVE |
Abstrakt, aber fröhlich. |
EXTRACTIVE |
Sehr knapper, extravaganter Stil. |
VERBOSE |
Ausführlicher Stil mit zusätzlichen Details. Die Antwort kann als Satz, Absatz, mehrere Absätze, Aufzählungspunkte usw. formatiert sein. |
InputFeedback
Feedback zu den Eingabedaten, die zur Beantwortung der Frage verwendet wurden, im Gegensatz zu einer von einem Modell generierten Antwort auf die Frage.
JSON-Darstellung |
---|
{ "safetyRatings": [ { object ( |
Felder | |
---|---|
safetyRatings[] |
Bewertungen zur Sicherheit der Eingabe. Pro Kategorie ist maximal eine Bewertung vorhanden. |
blockReason |
Optional. Wenn festgelegt, wurde die Eingabe blockiert und es werden keine Kandidaten zurückgegeben. Formulieren Sie Ihre Eingabe um. |
BlockReason
Gibt an, warum die Eingabe blockiert wurde.
Enums | |
---|---|
BLOCK_REASON_UNSPECIFIED |
Standardwert Dieser Wert wird nicht verwendet. |
SAFETY |
Eingabe wurde aus Sicherheitsgründen blockiert. Sie können safetyRatings untersuchen, um herauszufinden, welche Sicherheitskategorie sie blockiert hat. |
OTHER |
Die Eingabe wurde aus anderen Gründen blockiert. |