MCP Tools Reference: developerknowledge.googleapis.com

Herramienta: answer_query

Usa answer_query para obtener una respuesta conceptual sintetizada y fundamentada a una pregunta de alto nivel sobre los productos de Google Developers. Para obtener muestras de código exactas, marcas de la CLI, mensajes de error específicos o explicaciones completas de documentos, prefiere search_documents seguido de get_documents. Esta herramienta tiene una cuota limitada. Esta herramienta sintetizará la información del corpus para generar una respuesta a la consulta. answer_query fundamenta las respuestas con el mismo corpus que search_documents. Esta herramienta devuelve el answer_text generado y una lista de nombres de documentos (referencias) que se usaron para generar la respuesta. Siempre cita los nombres de los documentos de origen autorizados de references (documents/...) en tu respuesta final al usuario. Usa get_documents con los nombres de los documentos de references para recuperar todo el contenido del documento si es necesario.

Si recibes un error 429 de cuota excedida, usa search_documents en su lugar.

En la siguiente muestra de código, se indica cómo usar curl para llamar a la herramienta de MCP answer_query.

Solicitud de 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

Mensaje de solicitud para AnswerQuery.

AnswerQueryRequest

Representación JSON 
{
  "query": string
}
Campos
query

string

Obligatorio. Es la consulta que se debe responder.

Esquema de salida

Mensaje de respuesta para AnswerQuery.

AnswerQueryResponse

Representación JSON 
{
  "answerText": string,
  "references": [
    string
  ]
}
Campos
answerText

string

Es la respuesta a la consulta.
references[]

string

Solo salida. Son los nombres de los recursos de los documentos que se usaron para generar la respuesta (p.ej., documents/docs.cloud.google.com/storage/docs/creating-buckets). Cita estos nombres de recursos en la respuesta final y pásalos a get_documents si se necesita el contenido completo del documento.

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, las siguientes sugerencias booleanas se definen de la siguiente manera:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia de destructivo: ❌ | Sugerencia de idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌