MCP Tools Reference: developerknowledge.googleapis.com

Tool: answer_query

Verwenden Sie „answer_query“, um eine fundierte, zusammengefasste konzeptionelle Antwort auf eine allgemeine Frage zu Google Developers-Produkten zu erhalten. Für genaue Codebeispiele, CLI-Flags, spezifische Fehlermeldungen oder vollständige Dokumentanleitungen sollten Sie stattdessen search_documents gefolgt von get_documents verwenden. Dieses Tool hat ein begrenztes Kontingent. Dieses Tool fasst Informationen aus dem Korpus zusammen, um eine Antwort auf die Anfrage zu generieren. „answer_query“ fundiert Antworten mit demselben Korpus wie „search_documents“. Dieses Tool gibt den generierten „answer_text“ und eine Liste der Dokumentnamen (Referenzen) zurück, die zum Generieren der Antwort verwendet wurden. Nenne in deiner endgültigen Antwort an den Nutzer immer die Namen der maßgeblichen Quelldokumente aus references (documents/...). Verwenden Sie get_documents mit den Dokumentnamen aus references, um bei Bedarf den gesamten Dokumentinhalt abzurufen.

Wenn Sie den Fehler „429 – Kontingent überschritten“ erhalten, verwenden Sie stattdessen „search_documents“.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool answer_query aufrufen.

Curl-Anfrage 
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "answer_query",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für AnswerQuery.

AnswerQueryRequest

JSON-Darstellung 
{
  "query": string
}
Felder
query

string

Erforderlich. Die zu beantwortende Anfrage.

Ausgabeschema

Antwortnachricht für AnswerQuery.

AnswerQueryResponse

JSON-Darstellung 
{
  "answerText": string,
  "references": [
    string
  ]
}
Felder
answerText

string

Die Antwort auf die Anfrage.
references[]

string

Nur Ausgabe. Die Ressourcennamen der Dokumente, die zum Generieren der Antwort verwendet wurden (z.B. documents/docs.cloud.google.com/storage/docs/creating-buckets). Zitieren Sie diese Ressourcennamen in der endgültigen Antwort und übergeben Sie sie an get_documents, wenn der vollständige Dokumentinhalt benötigt wird.

Tool-Annotationen

Tool-Anmerkungen werden an MCP-Clients gesendet, um das grundlegende Risiko eines bestimmten Tools zu beschreiben. Die meisten Clients behandeln diese Hinweise als nicht vertrauenswürdig, sie können jedoch verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Zusätzlich zum Titelstring werden die folgenden booleschen Hinweise definiert:

  • readOnlyHint: Wenn „true“, ändert das Tool seine Umgebung nicht. Standardeinstellung: false.
  • destructiveHint: Wenn „true“, kann das Tool destruktive Aktionen ausführen. Wenn „false“, kann das Tool nur additive Aktionen ausführen. Standardeinstellung: true.
  • idempotentHint: Wenn „true“, hat das wiederholte Aufrufen des Tools mit denselben Argumenten keine zusätzlichen Auswirkungen auf die Umgebung. Standardeinstellung: false.
  • openWorldHint: Wenn „true“, kann das Tool mit einer „offenen Welt“ externer Entitäten interagieren. Wenn „false“, kann das Tool nur mit internen Entitäten interagieren. Ein Websuchtool wäre beispielsweise ein Open-World-Tool, ein Speichertool dagegen nicht.

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Lesezugriff-Hinweis: ✅ | Open-World-Hinweis: ❌