MCP Tools Reference: developerknowledge.googleapis.com

Ferramenta: search_documents

Use essa ferramenta para encontrar documentação sobre produtos do Google para desenvolvedores. Os documentos contêm APIs oficiais, snippets de código, notas de versão, práticas recomendadas, guias, informações de depuração e muito mais. Ela 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

  • Gemini CLI: geminicli.com

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

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

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

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Essa ferramenta retorna blocos de texto, nomes e URLs para documentos correspondentes. Se os blocos 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.

O exemplo de código a seguir mostra como usar curl para chamar a ferramenta search_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": "search_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 search_documents. Use o campo de consulta para pesquisar a documentação relacionada do Google para desenvolvedores.

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 documento nessa lista contém um snippet de conteúdo relevante para a consulta de pesquisa. Use o campo DocumentChunk.name 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 a que esse bloco pertence. Formato: documents/{uri_without_scheme} Exemplo: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

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

string

Apenas saída. O conteúdo do bloco de documentos.

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 prompt 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: ❌