MCP Tools Reference: developerknowledge.googleapis.com

Outil : get_documents

Utilisez cet outil pour récupérer l'intégralité du contenu d'un seul document ou de 20 documents maximum en un seul appel. Les noms des documents doivent être obtenus à partir du champ parent des résultats d'un appel à l'outil search_documents ou du champ references renvoyé par l'outil answer_query. Définissez le paramètre names sur une liste de noms de documents (documents/...) et citez les documents sources faisant autorité utilisés dans votre réponse finale.

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP get_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": "get_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 get_documents.

GetDocumentsRequest

Représentation JSON 
{
  "names": [
    string
  ]
}
Champs
names[]

string

Obligatoire. Noms des documents à récupérer, tels qu'ils sont renvoyés par le champ parent des résultats search_documents ou le champ references de answer_query. Vous pouvez récupérer jusqu'à 20 documents en un seul appel. Les documents sont renvoyés dans le même ordre que les names de la requête. Format : documents/{uri_without_scheme} Exemple : documents/docs.cloud.google.com/storage/docs/creating-buckets

Schéma de sortie

Schéma de réponse pour get_documents.

GetDocumentsResponse

Représentation JSON 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Champs
documents[]

object (Document)

Documents demandés.

Document

Représentation JSON 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Champs
name

string

Identifiant. Nom de ressource du document. Format : documents/{uri_without_scheme} Exemple : documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Uniquement en sortie. L'URI du contenu, par exemple https://cloud.google.com/storage/docs/creating-buckets.
content

string

Uniquement en sortie. Contenu du document au format Markdown.
description

string

Uniquement en sortie. Description du document.
title

string

Uniquement en sortie. Titre du 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 : ❌