MCP Tools Reference: developerknowledge.googleapis.com

Narzędzie: get_documents

Za pomocą tego narzędzia możesz pobrać pełną treść pojedynczego dokumentu lub maksymalnie 20 dokumentów w jednym wywołaniu. Nazwy dokumentów powinny być pobierane z pola parent wyników wywołania narzędzia search_documents lub z pola references zwracanego przez narzędzie answer_query. Ustaw parametr names na listę nazw dokumentów (documents/...) i podaj w odpowiedzi końcowej wiarygodne dokumenty źródłowe, które zostały użyte.

Poniższy przykładowy kod pokazuje, jak używać curl do wywoływania narzędzia MCP get_documents.

Żądanie Curl 
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
}'

Schemat wejściowy

Schemat żądania dla: get_documents.

GetDocumentsRequest

Zapis JSON 
{
  "names": [
    string
  ]
}
Pola
names[]

string

Wymagane. Nazwy dokumentów do pobrania, zwracane przez pole parent wyników search_documents lub pole references elementu answer_query. W jednym wywołaniu można pobrać maksymalnie 20 dokumentów. Dokumenty są zwracane w tej samej kolejności co names w żądaniu. Format: documents/{uri_without_scheme} Przykład: documents/docs.cloud.google.com/storage/docs/creating-buckets

Schemat wyjściowy

Schemat odpowiedzi dla: get_documents.

GetDocumentsResponse

Zapis JSON 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Pola
documents[]

object (Document)

Poprosiliśmy o dokumenty.

Dokument

Zapis JSON 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Pola
name

string

Identyfikator. Nazwa zasobu dokumentu. Format: documents/{uri_without_scheme} Przykład: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Tylko dane wyjściowe. Identyfikator URI treści, np. https://cloud.google.com/storage/docs/creating-buckets.
content

string

Tylko dane wyjściowe. Treść dokumentu w formacie Markdown.
description

string

Tylko dane wyjściowe. Opis dokumentu.
title

string

Tylko dane wyjściowe. Tytuł dokumentu.

Adnotacje dotyczące narzędzi

Adnotacje narzędzi są wysyłane do klientów MCP, aby opisać podstawowe ryzyko związane z danym narzędziem. Większość klientów traktuje te wskazówki jako niezaufane, ale można ich użyć do określenia, kiedy wysłać użytkownikowi prośbę o potwierdzenie.

Oprócz ciągu tytułu zdefiniowane są te wskazówki logiczne:

  • readOnlyHint: jeśli ma wartość true, narzędzie nie modyfikuje swojego środowiska. Wartość domyślna: false.
  • destructiveHint: jeśli ma wartość „true”, narzędzie może wykonywać działania destrukcyjne. Jeśli ma wartość false, narzędzie może wykonywać tylko działania dodawania. Wartość domyślna: true.
  • idempotentHint: jeśli ma wartość „true”, wielokrotne wywoływanie narzędzia z tymi samymi argumentami nie będzie miało dodatkowego wpływu na jego środowisko. Wartość domyślna: false.
  • openWorldHint: jeśli ma wartość true, narzędzie może wchodzić w interakcje z „otwartym światem” podmiotów zewnętrznych. Jeśli ma wartość false, narzędzie może wchodzić w interakcje tylko z encjami wewnętrznymi. Na przykład narzędzie do wyszukiwania w internecie jest narzędziem typu Otwarty świat, a narzędzie do zapamiętywania – nie.

Wskazówka dotycząca niszczenia: ❌ | Wskazówka dotycząca idempotencji: ✅ | Wskazówka dotycząca tylko do odczytu: ✅ | Wskazówka dotycząca otwartego świata: ❌