MCP Tools Reference: developerknowledge.googleapis.com

Strumento: search_documents

Utilizza questo strumento per trovare la documentazione sui prodotti Google Developers. I documenti contengono API ufficiali, snippet di codice, note di rilascio, best practice, guide, informazioni di debug e altro ancora. Riguarda i seguenti prodotti e domini:

  • 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

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

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

  • Google Developers, Ads, Ricerca, 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

Questo strumento restituisce blocchi di testo, nomi e URI per i documenti corrispondenti. Preferisci search_documents seguito da get_documents quando hai bisogno di esempi di codice esatti, flag CLI, messaggi di errore specifici, procedure dettagliate dei tutorial o ricerca di parole chiave deterministica. Se i segmenti restituiti non sono abbastanza dettagliati per rispondere alla domanda dell'utente, utilizza get_documents con parent dall'output di questo strumento per recuperare i contenuti completi del documento. Quando rispondi all'utente, cita sempre i nomi delle risorse dei documenti di origine autorevoli (documents/...) o gli URI.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP search_documents.

Richiesta 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
}'

Schema di input

Schema della richiesta per search_documents. Utilizza il campo query per cercare la documentazione per lo sviluppo di Google correlata.

SearchDocumentChunksRequest

Rappresentazione JSON 
{
  "query": string
}
Campi
query

string

Obbligatorio. La stringa di query non elaborata fornita dall'utente, ad esempio "Come si crea un bucket Cloud Storage?".

Schema di output

Schema di risposta per search_documents.

SearchDocumentChunksResponse

Rappresentazione JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
Campi
results[]

object (DocumentChunk)

I risultati di ricerca per la query specificata. Ogni DocumentChunk in questo elenco contiene uno snippet di contenuti pertinenti alla query di ricerca. Utilizza il campo DocumentChunk.parent di ogni risultato con get_documents per recuperare i contenuti completi del documento.

DocumentChunk

Rappresentazione JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
Campi
parent

string

Solo output. Il nome della risorsa del documento da cui proviene questo chunk. Formato: documents/{uri_without_scheme} Esempio: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Solo output. L'ID di questo segmento all'interno del documento. L'ID segmento è univoco all'interno di un documento, ma non a livello globale tra i documenti. L'ID del chunk non è stabile e potrebbe cambiare nel tempo.
content

string

Solo output. I contenuti del segmento di documento.

Annotazioni dello strumento

Le annotazioni degli strumenti vengono inviate ai client MCP per descrivere il rischio di base di un determinato strumento. La maggior parte dei client considera questi suggerimenti non attendibili, ma possono essere utilizzati per decidere quando inviare una richiesta di conferma a un utente.

Oltre alla stringa del titolo, i seguenti suggerimenti booleani sono definiti come segue:

  • readOnlyHint: se true, lo strumento non modifica il suo ambiente. Valore predefinito: false.
  • destructiveHint: se true, lo strumento può eseguire azioni distruttive. Se false, lo strumento può eseguire solo azioni additive. Valore predefinito: true.
  • idempotentHint: se true, la chiamata ripetuta dello strumento con gli stessi argomenti non avrà alcun effetto aggiuntivo sul suo ambiente. Valore predefinito: false.
  • openWorldHint: se true, lo strumento può interagire con un "open world" di entità esterne. Se false, lo strumento può interagire solo con entità interne. Ad esempio, uno strumento di ricerca web sarebbe open world, mentre uno strumento di memoria no.

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌