MCP Tools Reference: developerknowledge.googleapis.com

Herramienta: get_documents

Usa esta herramienta para recuperar el contenido completo de un solo documento o de hasta 20 documentos en una sola llamada. Los nombres de los documentos se deben obtener del campo parent de los resultados de una llamada a la herramienta search_documents o del campo references que devuelve la herramienta answer_query. Establece el parámetro names en una lista de nombres de documentos (documents/...) y cita los documentos de origen autorizados que se usaron en tu respuesta final.

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

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

Esquema de entrada

Esquema de solicitud para get_documents.

GetDocumentsRequest

Representación JSON 
{
  "names": [
    string
  ]
}
Campos
names[]

string

Obligatorio. Son los nombres de los documentos que se recuperarán, como los que muestra el campo parent de los resultados de search_documents o el campo references de answer_query. Se puede recuperar un máximo de 20 documentos en una llamada. Los documentos se devuelven en el mismo orden que los names de la solicitud. Formato: documents/{uri_without_scheme} Ejemplo: documents/docs.cloud.google.com/storage/docs/creating-buckets

Esquema de salida

Esquema de respuesta para get_documents.

GetDocumentsResponse

Representación JSON 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Campos
documents[]

object (Document)

Se solicitaron documentos.

Documento

Representación JSON 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Campos
name

string

Es el identificador. Es el nombre del recurso del documento. Formato: documents/{uri_without_scheme} Ejemplo: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Solo salida. Es el URI del contenido, como https://cloud.google.com/storage/docs/creating-buckets.
content

string

Solo salida. Es el contenido del documento en formato Markdown.
description

string

Solo salida. Es una descripción del documento.
title

string

Solo salida. Es el título 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: ❌