MCP Tools Reference: developerknowledge.googleapis.com

Ferramenta: answer_query

Use answer_query para receber uma resposta conceitual, fundamentada e sintetizada a uma pergunta de alto nível sobre os produtos do Google Developers. Para exemplos de código exatos, flags da CLI, mensagens de erro específicas ou tutoriais completos de documentos, prefira search_documents seguido por get_documents. Essa ferramenta tem uma cota limitada. Essa ferramenta sintetiza as informações do corpus para gerar uma resposta à consulta. O answer_query embasa as respostas usando o mesmo corpus que o search_documents. Essa ferramenta retorna o answer_text gerado e uma lista de nomes de documentos (referências) usados para gerar a resposta. Sempre cite os nomes dos documentos de origem confiáveis de references (documents/...) na sua resposta final ao usuário. Use get_documents com os nomes de documentos de references para buscar todo o conteúdo do documento, se necessário.

Se você receber um erro 429 de cota excedida, use search_documents.

O exemplo de código abaixo mostra como usar curl para chamar a ferramenta MCP answer_query.

Solicitação 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
}'

Esquema de entrada

Mensagem de solicitação para AnswerQuery.

AnswerQueryRequest

Representação JSON 
{
  "query": string
}
Campos
query

string

Obrigatório. A consulta a ser respondida.

Esquema de saída

Mensagem de resposta para AnswerQuery.

AnswerQueryResponse

Representação JSON 
{
  "answerText": string,
  "references": [
    string
  ]
}
Campos
answerText

string

A resposta à consulta.
references[]

string

Apenas saída. Os nomes de recursos dos documentos usados para gerar a resposta (por exemplo, documents/docs.cloud.google.com/storage/docs/creating-buckets). Cite esses nomes de recursos na resposta final e transmita-os para get_documents se o conteúdo completo do documento for necessário.

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas:

  • readOnlyHint: se for verdadeiro, a ferramenta não modifica o ambiente. (Padrão: falso).
  • destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. (Padrão: falso).
  • openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de jogos de mundo aberto: ❌