MCP Tools Reference: developerknowledge.googleapis.com

Outil : search_documents

Utilisez cet outil pour trouver de la documentation sur les produits Google pour les développeurs. Les documents contiennent des API officielles, des extraits de code, des notes de version, des bonnes pratiques, des guides, des informations de débogage, etc. Il couvre les produits et domaines suivants :

  • 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

  • IA de Google : ai.google.dev

  • Google Antigravity : antigravity.google

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

  • Google Developers, Ads, Search, Google Maps, YouTube : developers.google.com

  • Google Home : developers.home.google.com

  • Google Maps Platform : mapsplatform.google.com

  • Google Workspace : knowledge.workspace.google.com

  • TensorFlow : www.tensorflow.org

  • Web : web.dev

Cet outil renvoie des fragments de texte, des noms et des URI pour les documents correspondants. Privilégiez search_documents suivi de get_documents lorsque vous avez besoin d'exemples de code exacts, d'options de CLI, de messages d'erreur spécifiques, de tutoriels complets ou d'une recherche déterministe par mot clé. Si les fragments renvoyés ne sont pas assez détaillés pour répondre à la question de l'utilisateur, utilisez get_documents avec l'parent de la sortie de cet outil pour récupérer l'intégralité du contenu du document. Lorsque vous répondez à l'utilisateur, indiquez toujours les noms de ressources (documents/...) ou les URI des documents sources faisant autorité.

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

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": "search_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Schéma de requête pour search_documents. Utilisez le champ query pour rechercher la documentation Google pour les développeurs associée.

SearchDocumentChunksRequest

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

string

Obligatoire. Chaîne de requête brute fournie par l'utilisateur, par exemple "Comment créer un bucket Cloud Storage ?".

Schéma de sortie

Schéma de réponse pour search_documents.

SearchDocumentChunksResponse

Représentation JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
Champs
results[]

object (DocumentChunk)

Résultats de recherche pour la requête donnée. Chaque DocumentChunk de cette liste contient un extrait de contenu pertinent pour la requête de recherche. Utilisez le champ DocumentChunk.parent de chaque résultat avec get_documents pour récupérer l'intégralité du contenu du document.

DocumentChunk

Représentation JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
Champs
parent

string

Uniquement en sortie. Nom de ressource du document dont provient ce fragment. Format : documents/{uri_without_scheme} Exemple : documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Uniquement en sortie. ID de ce fragment dans le document. L'ID de fragment est unique dans un document, mais pas de manière globale dans tous les documents. L'ID de fragment n'est pas stable et peut changer au fil du temps.
content

string

Uniquement en sortie. Contenu du fragment de document.

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