MCP Tools Reference: developerknowledge.googleapis.com

Alat: get_documents

Gunakan alat ini untuk mengambil konten lengkap satu dokumen atau hingga 20 dokumen dalam satu panggilan. Nama dokumen harus diperoleh dari kolom parent hasil panggilan ke alat search_documents. Setel parameter names ke daftar nama dokumen.

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 tool's MCP 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 search_documents. Maksimum 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. Isi 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.

Selain 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 merusak. Jika salah (false), alat hanya dapat melakukan tindakan tambahan. Default: true.
  • idempotentHint: Jika benar (true), memanggil alat berulang kali dengan argumen yang sama tidak akan memberikan efek tambahan pada lingkungannya. Default: false.
  • openWorldHint: Jika benar, alat dapat berinteraksi dengan 'dunia terbuka' entitas eksternal. Jika salah (false), alat hanya dapat berinteraksi dengan entitas internal. Misalnya, alat penelusuran web akan menjadi open world, sedangkan alat memori tidak akan menjadi open world.

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌