MCP Tools Reference: developerknowledge.googleapis.com

Outil : answer_query

Utilisez answer_query pour obtenir une réponse conceptuelle synthétisée et ancrée à une question de haut niveau sur les produits Google Developers. Pour obtenir des exemples de code exacts, des options de CLI, des messages d'erreur spécifiques ou des tutoriels complets, privilégiez plutôt search_documents suivi de get_documents. Cet outil dispose d'un quota limité. Cet outil synthétise les informations du corpus pour générer une réponse à la requête. answer_query fonde les réponses sur le même corpus que search_documents. Cet outil renvoie le texte de réponse généré et une liste de noms de documents (références) utilisés pour générer la réponse. Citez toujours les noms des documents sources faisant autorité de references (documents/...) dans votre réponse finale à l'utilisateur. Utilisez get_documents avec les noms de documents de references pour récupérer l'intégralité du contenu du document si nécessaire.

Si vous obtenez une erreur 429 de dépassement de quota, utilisez plutôt search_documents.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP answer_query.

Requête 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
}'

Schéma d'entrée

Message de requête pour AnswerQuery.

AnswerQueryRequest

Représentation JSON 
{
  "query": string
}
Champs
query

string

Obligatoire. Requête à laquelle répondre.

Schéma de sortie

Message de réponse pour AnswerQuery.

AnswerQueryResponse

Représentation JSON 
{
  "answerText": string,
  "references": [
    string
  ]
}
Champs
answerText

string

Réponse à la requête.
references[]

string

Uniquement en sortie. Noms de ressources des documents utilisés pour générer la réponse (par exemple, documents/docs.cloud.google.com/storage/docs/creating-buckets). Citez ces noms de ressources dans la réponse finale et transmettez-les à get_documents si le contenu complet du document est nécessaire.

Annotations d'outils

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients considèrent ces indications comme non fiables, mais elles peuvent être utilisées pour décider quand une invite de confirmation peut être envoyée à un utilisateur.

En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", l'appel répété de l'outil avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche sur le Web est en monde ouvert, tandis qu'un outil de mémoire ne l'est pas.

Indication de destruction : ❌ | Indication d'idempotence : ✅ | Indication de lecture seule : ✅ | Indication en monde ouvert : ❌