MCP Tools Reference: developerknowledge.googleapis.com

Strumento: answer_query

Utilizza answer_query per ottenere una risposta concettuale sintetizzata e fondata a una domanda di alto livello sui prodotti Google Developers. Per esempi di codice esatti, flag dell'interfaccia a riga di comando, messaggi di errore specifici o procedure dettagliate per i documenti completi, preferisci search_documents seguito da get_documents. Questo strumento ha una quota limitata. Questo strumento sintetizzerà le informazioni del corpus per generare una risposta alla query. answer_query basa le risposte sullo stesso corpus di search_documents. Questo strumento restituisce il testo della risposta generato e un elenco di nomi di documenti (riferimenti) utilizzati per generare la risposta. Cita sempre i nomi dei documenti delle fonti autorevoli di references (documents/...) nella tua risposta finale all'utente. Utilizza get_documents con i nomi dei documenti di references per recuperare l'intero contenuto del documento, se necessario.

Se ricevi un errore 429 di quota esaurita, utilizza search_documents.

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

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": "answer_query",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per AnswerQuery.

AnswerQueryRequest

Rappresentazione JSON 
{
  "query": string
}
Campi
query

string

Obbligatorio. La query a cui rispondere.

Schema di output

Messaggio di risposta per AnswerQuery.

AnswerQueryResponse

Rappresentazione JSON 
{
  "answerText": string,
  "references": [
    string
  ]
}
Campi
answerText

string

La risposta alla query.
references[]

string

Solo output. I nomi delle risorse dei documenti utilizzati per generare la risposta (ad es. documents/docs.cloud.google.com/storage/docs/creating-buckets). Cita questi nomi delle risorse nella risposta finale e passali a get_documents se è necessario il contenuto completo 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: ❌