MCP Tools Reference: developerknowledge.googleapis.com

Strumento: get_documents

Utilizza questo strumento per recuperare i contenuti completi di un singolo documento o di un massimo di 20 documenti in una singola chiamata. I nomi dei documenti devono essere ottenuti dal campo parent dei risultati di una chiamata allo strumento search_documents o dal campo references restituito dallo strumento answer_query. Imposta il parametro names su un elenco di nomi di documenti (documents/...) e cita i documenti di origine autorevoli utilizzati nella risposta finale.

Il seguente esempio di codice mostra come utilizzare curl per chiamare lo strumento MCP get_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": "get_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Schema della richiesta per get_documents.

GetDocumentsRequest

Rappresentazione JSON 
{
  "names": [
    string
  ]
}
Campi
names[]

string

Obbligatorio. I nomi dei documenti da recuperare, come restituiti dal campo parent dei risultati di search_documents o dal campo references di answer_query. È possibile recuperare un massimo di 20 documenti in una singola chiamata. I documenti vengono restituiti nello stesso ordine di names nella richiesta. Formato: documents/{uri_without_scheme} Esempio: documents/docs.cloud.google.com/storage/docs/creating-buckets

Schema di output

Schema di risposta per get_documents.

GetDocumentsResponse

Rappresentazione JSON 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Campi
documents[]

object (Document)

Documenti richiesti.

Documento

Rappresentazione JSON 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Campi
name

string

Identificatore. Il nome della risorsa del documento. Formato: documents/{uri_without_scheme} Esempio: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Solo output. L'URI dei contenuti, ad esempio https://cloud.google.com/storage/docs/creating-buckets.
content

string

Solo output. I contenuti del documento in formato Markdown.
description

string

Solo output. Una descrizione del documento.
title

string

Solo output. Il titolo del 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: ❌