MCP Tools Reference: developerknowledge.googleapis.com

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

Этот инструмент позволяет находить документацию по продуктам Google для разработчиков. В документах содержатся официальные API, фрагменты кода, примечания к выпуску, рекомендации, руководства, сведения для отладки и многое другое. Она распространяется на следующие продукты и домены:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Gemini CLI: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com и docs.cloud.google.com

  • Google Developers, Реклама, Поиск, Google Карты, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Платформа Google Карт: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Веб-сайт: web.dev

Этот инструмент возвращает фрагменты текста, названия и URI для соответствующих документов. Используйте search_documents, а затем get_documents, если вам нужны точные примеры кода, флаги CLI, определенные сообщения об ошибках, полные пошаговые руководства или детерминированный поиск по ключевым словам. Если возвращенные фрагменты недостаточно подробны, чтобы ответить на вопрос пользователя, используйте get_documents с parent из выходных данных этого инструмента, чтобы получить полное содержимое документа. Отвечая пользователю, всегда указывайте названия ресурсов (documents/...) или URI авторитетных исходных документов.

В примере кода ниже показано, как использовать curl для вызова инструмента MCP search_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": "search_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Схема запроса для search_documents. Используйте поле query, чтобы найти нужную документацию Google для разработчиков.

SearchDocumentChunksRequest

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

string

Обязательно. Необработанная строка запроса, предоставленная пользователем, например "Как создать сегмент Cloud Storage?".

Схема вывода

Схема ответа для search_documents.

SearchDocumentChunksResponse

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

object (DocumentChunk)

Результаты поиска по заданному запросу. Каждый DocumentChunk в этом списке содержит фрагмент контента, соответствующий поисковому запросу. Используйте поле DocumentChunk.parent каждого результата с get_documents, чтобы получить полное содержимое документа.

DocumentChunk

JSON-представление 
{
  "parent": string,
  "id": string,
  "content": string
}
Поля
parent

string

Только для вывода. Название ресурса документа, из которого взят этот фрагмент. Формат: documents/{uri_without_scheme}. Пример: documents/docs.cloud.google.com/storage/docs/creating-buckets.
id

string

Только для вывода. Идентификатор фрагмента в документе. Идентификатор фрагмента уникален в пределах документа, но не во всех документах. Идентификатор фрагмента не является стабильным и может со временем меняться.
content

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: ❌