MCP Tools Reference: developerknowledge.googleapis.com

Инструмент: get_documents

Используйте этот инструмент для получения полного содержимого одного документа или до 20 документов за один вызов. Названия документов следует брать из поля parent результатов вызова инструмента search_documents . Установите параметр names в виде списка названий документов.

Приведённый ниже пример кода демонстрирует, как использовать curl для вызова инструмента MCP get_documents .

Запрос 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
}'

Схема ввода

Запрос схемы для функции get_documents.

GetDocumentsRequest

JSON-представление 
{
  "names": [
    string
  ]
}
Поля
names[]

string

Обязательно. Названия документов для извлечения, возвращаемые функцией search_documents. За один вызов можно извлечь максимум 20 документов. Документы возвращаются в том же порядке, что и names в запросе. Формат: documents/{uri_without_scheme} Пример: documents/docs.cloud.google.com/storage/docs/creating-buckets

Схема вывода

Схема ответа для функции get_documents.

GetDocumentsResponse

JSON-представление 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Поля
documents[]

object ( Document )

Запрошенные документы.

Документ

JSON-представление 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Поля
name

string

Идентификатор. Имя ресурса документа. Формат: documents/{uri_without_scheme} Пример: documents/docs.cloud.google.com/storage/docs/creating-buckets

uri

string

Только вывод. URI контента, например, https://cloud.google.com/storage/docs/creating-buckets .

content

string

Только вывод. Содержимое документа в формате Markdown.

description

string

Только вывод. Описание документа.

title

string

Только вывод. Заголовок документа.

Аннотации инструментов

Аннотации к инструментам отправляются клиентам MCP для описания основных рисков, связанных с данным инструментом. Большинство клиентов считают эти подсказки недостоверными, но они могут использоваться для определения момента отправки пользователю запроса на подтверждение.

Наряду со строкой заголовка, определены следующие логические подсказки:

  • readOnlyHint : Если true, инструмент не изменяет свою среду. По умолчанию: false.
  • destructiveHint : Если true, то инструмент может выполнять деструктивные действия. Если false, то инструмент может выполнять только аддитивные действия. По умолчанию: true.
  • idempotentHint : Если true, то многократный вызов инструмента с одними и теми же аргументами не окажет дополнительного влияния на его окружение. По умолчанию: false.
  • openWorldHint : Если true, то инструмент может взаимодействовать с «открытым миром» внешних объектов. Если false, то инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет представлять собой открытый мир, а инструмент для работы с памятью — нет.

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌