MCP Tools Reference: developerknowledge.googleapis.com

Ferramenta: search_documents

Use esta ferramenta para encontrar documentação sobre os produtos do Google Developers. Os documentos contêm APIs oficiais, snippets de código, notas da versão, práticas recomendadas, guias, informações de depuração e muito mais. Ele abrange os seguintes produtos e domínios:

  • 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

  • CLI do Gemini: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • IA do Google: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com e docs.cloud.google.com

  • Google Developers, Ads, Pesquisa, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Plataforma Google Maps: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Essa ferramenta retorna blocos de texto, nomes e URIs para documentos correspondentes. Prefira search_documents seguido por get_documents quando precisar de exemplos de código exatos, flags da CLI, mensagens de erro específicas, tutoriais completos ou pesquisa de palavras-chave determinística. Se os trechos retornados não forem detalhados o suficiente para responder à pergunta do usuário, use get_documents com o parent da saída dessa ferramenta para recuperar o conteúdo completo do documento. Ao responder ao usuário, sempre cite os nomes de recursos (documents/...) ou URIs do documento de origem confiável.

O exemplo de código abaixo mostra como usar curl para chamar a ferramenta MCP search_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": "search_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Esquema de solicitação para search_documents. Use o campo query para pesquisar a documentação relacionada para desenvolvedores do Google.

SearchDocumentChunksRequest

Representação JSON 
{
  "query": string
}
Campos
query

string

Obrigatório. A string de consulta bruta fornecida pelo usuário, como "Como criar um bucket do Cloud Storage?".

Esquema de saída

Esquema de resposta para search_documents.

SearchDocumentChunksResponse

Representação JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
Campos
results[]

object (DocumentChunk)

Os resultados da pesquisa para a consulta fornecida. Cada DocumentChunk nessa lista contém um snippet de conteúdo relevante para a consulta de pesquisa. Use o campo DocumentChunk.parent de cada resultado com get_documents para recuperar o conteúdo completo do documento.

DocumentChunk

Representação JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
Campos
parent

string

Apenas saída. O nome do recurso do documento de origem do fragmento. Formato: documents/{uri_without_scheme} Exemplo: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Apenas saída. O ID desse fragmento no documento. O ID do fragmento é exclusivo em um documento, mas não globalmente em todos os documentos. O ID do bloco não é estável e pode mudar com o tempo.
content

string

Apenas saída. O conteúdo do fragmento 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: ❌