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 aus dem Feld parent der Ergebnisse eines Aufrufs des Tools search_documents stammen. Legen Sie für den Parameter names eine Liste von Dokumentnamen fest.

Das folgende Codebeispiel zeigt, wie Sie curl verwenden, um das MCP-Tool get_documents aufzurufen.

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 tool's MCP 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 von search_documents zurückgegeben. 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)

Angefragte Dokumente.

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.

Toolanmerkungen

Toolanmerkungen 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 aber verwendet werden, um zu entscheiden, wann eine Bestätigungsaufforderung an einen Nutzer gesendet werden soll.

Neben dem Titelstring sind die folgenden booleschen Hinweise definiert:

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

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Hinweis „Nur lesen“: ✅ | Hinweis „Offene Welt“: ❌