MCP Tools Reference: developerknowledge.googleapis.com

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

Используйте этот инструмент, чтобы получить полное содержимое одного документа или до 20 документов за один вызов. Названия документов должны быть получены из поля parent результатов вызова инструмента search_documents или поля references, возвращенного инструментом answer_query. Задайте для параметра names список названий документов (documents/...) и укажите авторитетные исходные документы, использованные в окончательном ответе.

В примере кода ниже показано, как использовать 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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Схема запроса для get_documents.

GetDocumentsRequest

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

string

Обязательно. Названия документов, которые нужно получить. Они возвращаются в поле parent результатов search_documents или в поле references answer_query. За один вызов можно получить не более 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, то инструмент может взаимодействовать только с внутренними объектами. Например, инструмент веб-поиска будет открытым миром, а инструмент памяти – нет.

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