MCP Tools Reference: developerknowledge.googleapis.com

Ferramenta: get_documents

Use essa ferramenta para recuperar o conteúdo completo de um único documento ou até 20 documentos em uma única chamada. Os nomes dos documentos precisam ser extraídos do campo parent dos resultados de uma chamada para a ferramenta search_documents. Defina o parâmetro names como uma lista de nomes de documentos.

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

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 tool's MCP 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 retornado por search_documents. É possível recuperar até 20 documentos em uma chamada. Os documentos são retornados na mesma ordem dos 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 da ferramenta

As anotações da ferramenta 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 aviso de confirmação pode ser enviado a um usuário.

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

  • 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 mundo aberto: ❌