MCP Tools Reference: developerknowledge.googleapis.com

Ferramenta: get_documents

Use essa ferramenta para recuperar o conteúdo completo de um único documento ou de até 20 documentos em uma única chamada. Os nomes dos documentos devem ser obtidos do campo parent dos resultados de uma chamada para a ferramenta search_documents ou do campo references retornado pela ferramenta answer_query. Defina o parâmetro names como uma lista de nomes de documentos (documents/...) e cite os documentos de origem confiáveis usados na resposta final.

O exemplo de código abaixo mostra como usar curl para chamar a ferramenta MCP get_documents.

Solicitação 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 solicitação para get_documents.

GetDocumentsRequest

Representação JSON 
{
  "names": [
    string
  ]
}
Campos
names[]

string

Obrigatório. Os nomes dos documentos a serem recuperados, conforme retornados pelo campo parent dos resultados de search_documents ou pelo campo references de answer_query. É possível recuperar no máximo 20 documentos em uma chamada. Os documentos são retornados na mesma ordem que os names na solicitação. Formato: documents/{uri_without_scheme} Exemplo: documents/docs.cloud.google.com/storage/docs/creating-buckets

Esquema de saída

Esquema de resposta para get_documents.

GetDocumentsResponse

Representação JSON 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Campos
documents[]

object (Document)

Documentos solicitados.

Documento

Representação JSON 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Campos
name

string

Identificador. O nome do recurso do documento. Formato: documents/{uri_without_scheme} Exemplo: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Apenas saída. O URI do conteúdo, como https://cloud.google.com/storage/docs/creating-buckets.
content

string

Apenas saída. O conteúdo do documento no formato Markdown.
description

string

Apenas saída. Uma descrição do documento.
title

string

Apenas saída. O título do documento.

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas:

  • readOnlyHint: se for verdadeiro, a ferramenta não modifica o ambiente. (Padrão: falso).
  • destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. (Padrão: falso).
  • openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ❌ | Dica idempotente: ✅ | Dica somente leitura: ✅ | Dica de jogos de mundo aberto: ❌