MCP Tools Reference: developerknowledge.googleapis.com

Narzędzie: get_documents

Za pomocą tego narzędzia możesz pobrać pełną treść jednego dokumentu lub maksymalnie 20 dokumentów w ramach jednego wywołania. Nazwy dokumentów powinny pochodzić z pola parent w wynikach wywołania narzędzia search_documents. Ustaw parametr names na listę nazw dokumentów.

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

Żą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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schemat danych wejściowych

Schemat żądania dla get_documents.

GetDocumentsRequest

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

string

Wymagane. Nazwy dokumentów do pobrania zwrócone przez funkcję search_documents. 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)

Wysłano prośbę 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 narzędzi

Adnotacje narzędzia 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żywać do określania, kiedy użytkownikowi może zostać wysłany monit o potwierdzenie.

Oprócz ciągu znaków tytułu zdefiniowano te wskazówki logiczne:

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

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌