MCP Tools Reference: developerknowledge.googleapis.com

Alat: answer_query

Gunakan answer_query untuk mendapatkan jawaban konseptual yang berlandaskan dan disintesis untuk pertanyaan tingkat tinggi tentang Google Developers. Untuk contoh kode yang tepat, flag CLI, pesan error tertentu, atau panduan dokumen lengkap, sebaiknya gunakan search_documents, diikuti dengan get_documents. Alat ini memiliki kuota terbatas. Alat ini akan menyintesis informasi dari korpus untuk menghasilkan jawaban atas kueri. answer_query mendasarkan jawaban menggunakan korpus yang sama dengan search_documents. Alat ini menampilkan answer_text yang dihasilkan dan daftar nama dokumen (referensi) yang digunakan untuk menghasilkan jawaban. Selalu sebutkan nama dokumen sumber yang kredibel dari references (documents/...) dalam respons akhir Anda kepada pengguna. Gunakan get_documents dengan nama dokumen dari references untuk mengambil seluruh konten dokumen jika diperlukan.

Jika Anda mendapatkan error kuota habis 429, gunakan search_documents.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP answer_query.

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

Skema Input

Pesan permintaan untuk AnswerQuery.

AnswerQueryRequest

Representasi JSON 
{
  "query": string
}
Kolom
query

string

Wajib. Kueri yang akan dijawab.

Skema Output

Pesan respons untuk AnswerQuery.

AnswerQueryResponse

Representasi JSON 
{
  "answerText": string,
  "references": [
    string
  ]
}
Kolom
answerText

string

Jawaban atas kueri.
references[]

string

Hanya output. Nama resource dokumen yang digunakan untuk menghasilkan jawaban (misalnya, documents/docs.cloud.google.com/storage/docs/creating-buckets). Kutip nama resource ini dalam respons akhir dan teruskan ke get_documents jika konten dokumen lengkap diperlukan.

Anotasi Alat

Anotasi alat dikirim ke klien MCP untuk menjelaskan risiko dasar alat tertentu. Sebagian besar klien memperlakukan petunjuk ini sebagai tidak tepercaya, tetapi petunjuk ini dapat digunakan untuk memutuskan kapan perintah konfirmasi dapat dikirim kepada pengguna.

Bersama dengan string judul, petunjuk boolean berikut ditentukan sebagai berikut:

  • readOnlyHint: Jika benar, alat tidak akan mengubah lingkungannya. Default: false.
  • destructiveHint: Jika benar, alat dapat melakukan tindakan destruktif. Jika salah (false), alat hanya dapat melakukan tindakan penambahan. Default: true.
  • idempotentHint: Jika benar, memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'open world' entitas eksternal. Jika salah, alat hanya dapat berinteraksi dengan entity internal. Misalnya, alat penelusuran web akan bersifat open world, sedangkan alat memori tidak akan bersifat open world.

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Open World: ❌