MCP Tools Reference: developerknowledge.googleapis.com

Tool: get_documents

Mit diesem Tool können Sie den vollständigen Inhalt eines einzelnen Dokuments oder von bis zu 20 Dokumenten in einem einzigen Aufruf abrufen. Die Dokumentnamen sollten entweder aus dem Feld parent der Ergebnisse eines Aufrufs des search_documents-Tools oder aus dem Feld references stammen, das vom answer_query-Tool zurückgegeben wird. Legen Sie den Parameter names auf eine Liste von Dokumentnamen (documents/...) fest und zitieren Sie die maßgeblichen Quelldokumente, die in Ihrer endgültigen Antwort verwendet wurden.

Das folgende Codebeispiel zeigt, wie Sie mit curl das MCP-Tool get_documents 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": "get_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfrageschema für get_documents.

GetDocumentsRequest

JSON-Darstellung 
{
  "names": [
    string
  ]
}
Felder
names[]

string

Erforderlich. Die Namen der abzurufenden Dokumente, wie sie im Feld parent der search_documents-Ergebnisse oder im Feld references von answer_query zurückgegeben werden. In einem Aufruf können maximal 20 Dokumente abgerufen werden. Die Dokumente werden in derselben Reihenfolge wie die names in der Anfrage zurückgegeben. Format: documents/{uri_without_scheme}, Beispiel: documents/docs.cloud.google.com/storage/docs/creating-buckets

Ausgabeschema

Antwortschema für get_documents.

GetDocumentsResponse

JSON-Darstellung 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Felder
documents[]

object (Document)

Dokumente angefordert.

Dokument

JSON-Darstellung 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Felder
name

string

ID. Der Ressourcenname des Dokuments. Format: documents/{uri_without_scheme}, Beispiel: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Nur Ausgabe. Der URI des Inhalts, z. B. https://cloud.google.com/storage/docs/creating-buckets.
content

string

Nur Ausgabe. Der Inhalt des Dokuments im Markdown-Format.
description

string

Nur Ausgabe. Eine Beschreibung des Dokuments.
title

string

Nur Ausgabe. Der Titel des Dokuments

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: ❌