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

  • Interface de ligne de commande Gemini : geminicli.com

  • Go: go.dev

  • Google AI: 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

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Cet outil renvoie des blocs de texte, des noms et des URL pour les documents correspondants. Si les blocs renvoyés ne sont pas suffisamment détaillés pour répondre à la question de l'utilisateur, utilisez get_documents avec le parent du résultat de cet outil pour récupérer l'intégralité du contenu du document.

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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

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

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 document de cette liste contient un extrait de contenu pertinent pour la requête de recherche. Utilisez le champ DocumentChunk.name 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 la ressource du document dont provient ce bloc. Format : documents/{uri_without_scheme} Exemple : documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

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

string

Uniquement en sortie. Contenu du bloc de document.

Annotations d'outil

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 traitent ces conseils comme non fiables, mais ils peuvent être utilisés pour déterminer quand une invite de confirmation peut être envoyée à un utilisateur.

Outre la chaîne de titre, les conseils booléens suivants sont définis 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 additives. 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 serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Conseil destructif : ❌ | Conseil idempotent : ✅ | Conseil en lecture seule : ✅ | Conseil en monde ouvert : ❌