MCP Tools Reference: developerknowledge.googleapis.com

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

Используйте answer_query, чтобы получить обоснованный источниками, синтезированный концептуальный ответ на вопрос высокого уровня о продуктах Google Developers. Если вам нужны точные примеры кода, флаги CLI, определенные сообщения об ошибках или полные пошаговые инструкции, лучше использовать search_documents, а затем get_documents. У этого инструмента ограниченная квота. Этот инструмент синтезирует информацию из корпуса, чтобы сгенерировать ответ на запрос. answer_query обосновывает ответы, используя тот же корпус, что и search_documents. Этот инструмент возвращает сгенерированный answer_text и список названий документов (ссылок), использованных для генерации ответа. В окончательном ответе пользователю всегда указывайте названия авторитетных исходных документов из references (documents/...). При необходимости используйте get_documents с названиями документов из references, чтобы получить все содержимое документа.

Если вы получаете ошибку 429, связанную с превышением квоты, используйте search_documents.

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

Запрос 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": "answer_query",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Схема ввода

Сообщение с запросом для AnswerQuery.

AnswerQueryRequest

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

string

Обязательно. Запрос, на который нужно ответить.

Схема вывода

Ответное сообщение для AnswerQuery.

AnswerQueryResponse

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

string

Ответ на запрос.
references[]

string

Только для вывода. Названия ресурсов документов, использованных для создания ответа (например, documents/docs.cloud.google.com/storage/docs/creating-buckets). Укажите эти названия ресурсов в итоговом ответе и передайте их в get_documents, если требуется полное содержимое документа.

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

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

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

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

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