MCP Tools Reference: developerknowledge.googleapis.com

Herramienta: search_documents

Usa esta herramienta para encontrar documentación sobre los productos para desarrolladores de Google. Los documentos contienen APIs oficiales, fragmentos de código, notas de la versión, prácticas recomendadas, guías, información de depuración y mucho más. Abarca los siguientes productos y dominios:

  • 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

  • Genkit: genkit.dev

  • Go: go.dev

  • IA de Google: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com y 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

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Esta herramienta devuelve fragmentos de texto, nombres y URIs de los documentos que coinciden. Prefiere search_documents seguido de get_documents cuando necesites muestras de código exactas, marcas de la CLI, mensajes de error específicos, guías de instructivos completas o búsqueda determinística de palabras clave. Si los fragmentos devueltos no son lo suficientemente detallados como para responder la pregunta del usuario, usa get_documents con el parent del resultado de esta herramienta para recuperar el contenido completo del documento. Cuando respondas al usuario, cita siempre los nombres de los recursos de los documentos de origen autorizados (documents/...) o los URIs.

En la siguiente muestra de código, se indica cómo usar curl para llamar a la herramienta de MCP search_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": "search_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Esquema de solicitud para search_documents. Usa el campo query para buscar documentación relacionada para desarrolladores de Google.

SearchDocumentChunksRequest

Representación JSON 
{
  "query": string
}
Campos
query

string

Obligatorio. Es la cadena de consulta sin procesar que proporciona el usuario, como "¿Cómo crear un bucket de Cloud Storage?".

Esquema de salida

Esquema de respuesta para search_documents.

SearchDocumentChunksResponse

Representación JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
Campos
results[]

object (DocumentChunk)

Son los resultados de la búsqueda para la consulta proporcionada. Cada DocumentChunk de esta lista contiene un fragmento de contenido relevante para la búsqueda. Usa el campo DocumentChunk.parent de cada resultado con get_documents para recuperar el contenido completo del documento.

DocumentChunk

Representación JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
Campos
parent

string

Solo salida. Es el nombre del recurso del documento del que proviene este fragmento. Formato: documents/{uri_without_scheme} Ejemplo: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Solo salida. Es el ID de este fragmento dentro del documento. El ID del fragmento es único dentro de un documento, pero no es único a nivel global en todos los documentos. El ID del fragmento no es estable y puede cambiar con el tiempo.
content

string

Solo salida. Es el contenido del fragmento 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: ❌