MCP Tools Reference: developerknowledge.googleapis.com

Alat: search_documents

Gunakan alat ini untuk menemukan dokumentasi tentang produk developer Google. Dokumen tersebut berisi API resmi, cuplikan kode, catatan rilis, praktik terbaik, panduan, info proses debug, dan lainnya. Sertifikasi ini mencakup produk dan domain berikut:

  • 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 & docs.cloud.google.com

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

Alat ini menampilkan potongan teks, nama, dan URI untuk dokumen yang cocok. Pilih search_documents diikuti dengan get_documents saat Anda memerlukan contoh kode yang tepat, flag CLI, pesan error tertentu, panduan tutorial lengkap, atau pencarian kata kunci deterministik. Jika potongan yang ditampilkan tidak cukup mendetail untuk menjawab pertanyaan pengguna, gunakan get_documents dengan parent dari output alat ini untuk mengambil konten dokumen lengkap. Saat menjawab pengguna, selalu kutip nama resource (documents/...) atau URI dokumen sumber yang kredibel.

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

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

Skema Input

Skema permintaan untuk search_documents. Gunakan kolom query untuk menelusuri dokumentasi developer Google terkait.

SearchDocumentChunksRequest

Representasi JSON 
{
  "query": string
}
Kolom
query

string

Wajib. String kueri mentah yang diberikan oleh pengguna, seperti "How to create a bucket Cloud Storage?".

Skema Output

Skema respons untuk search_documents.

SearchDocumentChunksResponse

Representasi JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
Kolom
results[]

object (DocumentChunk)

Hasil penelusuran untuk kueri yang diberikan. Setiap DocumentChunk dalam daftar ini berisi cuplikan konten yang relevan dengan kueri penelusuran. Gunakan kolom DocumentChunk.parent dari setiap hasil dengan get_documents untuk mengambil konten dokumen lengkap.

DocumentChunk

Representasi JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
Kolom
parent

string

Hanya output. Nama resource dokumen tempat chunk ini berasal. Format: documents/{uri_without_scheme} Contoh: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Hanya output. ID potongan ini dalam dokumen. ID potongan bersifat unik dalam dokumen, tetapi tidak unik secara global di seluruh dokumen. ID potongan tidak stabil dan dapat berubah seiring waktu.
content

string

Hanya output. Konten potongan dokumen.

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: ❌