MCP Tools Reference: developerknowledge.googleapis.com

Alat: get_documents

Gunakan alat ini untuk mengambil konten lengkap dari satu dokumen atau hingga 20 dokumen dalam satu panggilan. Nama dokumen harus diperoleh dari kolom parent hasil dari panggilan ke alat search_documents atau kolom references yang ditampilkan oleh alat answer_query. Tetapkan parameter names ke daftar nama dokumen (documents/...), dan kutip dokumen sumber otoritatif yang digunakan dalam respons akhir Anda.

Contoh kode berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP get_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": "get_documents",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Skema permintaan untuk get_documents.

GetDocumentsRequest

Representasi JSON 
{
  "names": [
    string
  ]
}
Kolom
names[]

string

Wajib. Nama dokumen yang akan diambil, seperti yang ditampilkan oleh kolom parent dari hasil search_documents atau kolom references dari answer_query. Maksimal 20 dokumen dapat diambil dalam satu panggilan. Dokumen ditampilkan dalam urutan yang sama dengan names dalam permintaan. Format: documents/{uri_without_scheme} Contoh: documents/docs.cloud.google.com/storage/docs/creating-buckets

Skema Output

Skema respons untuk get_documents.

GetDocumentsResponse

Representasi JSON 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Kolom
documents[]

object (Document)

Dokumen diminta.

Dokumen

Representasi JSON 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Kolom
name

string

ID. Nama resource dokumen. Format: documents/{uri_without_scheme} Contoh: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Hanya output. URI konten, seperti https://cloud.google.com/storage/docs/creating-buckets.
content

string

Hanya output. Konten dokumen dalam format Markdown.
description

string

Hanya output. Deskripsi dokumen.
title

string

Hanya output. Judul 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: ❌