MCP Tools Reference: developerknowledge.googleapis.com

Công cụ: get_documents

Sử dụng công cụ này để truy xuất toàn bộ nội dung của một tài liệu hoặc tối đa 20 tài liệu trong một lệnh gọi. Bạn nên lấy tên tài liệu từ trường parent của kết quả từ một lệnh gọi đến công cụ search_documents. Đặt tham số names thành danh sách tên tài liệu.

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ get_documents MCP.

Yêu cầu 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
}'

Giản đồ đầu vào

Giản đồ yêu cầu cho get_documents.

GetDocumentsRequest

Biểu diễn dưới dạng JSON 
{
  "names": [
    string
  ]
}
Trường
names[]

string

Bắt buộc. Tên của các tài liệu cần truy xuất, do search_documents trả về. Bạn có thể truy xuất tối đa 20 tài liệu trong một lệnh gọi. Các tài liệu được trả về theo thứ tự giống như names trong yêu cầu. Định dạng: documents/{uri_without_scheme} Ví dụ: documents/docs.cloud.google.com/storage/docs/creating-buckets

Giản đồ đầu ra

Giản đồ phản hồi cho get_documents.

GetDocumentsResponse

Biểu diễn dưới dạng JSON 
{
  "documents": [
    {
      object (Document)
    }
  ]
}
Trường
documents[]

object (Document)

Giấy tờ được yêu cầu.

Tài liệu

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
Trường
name

string

Giá trị nhận dạng. Tên tài nguyên của tài liệu. Định dạng: documents/{uri_without_scheme} Ví dụ: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

Chỉ có đầu ra. URI của nội dung, chẳng hạn như https://cloud.google.com/storage/docs/creating-buckets.
content

string

Chỉ có đầu ra. Nội dung của tài liệu ở định dạng Markdown.
description

string

Chỉ có đầu ra. Nội dung mô tả về tài liệu.
title

string

Chỉ có đầu ra. Tiêu đề của tài liệu.

Chú giải công cụ

Chú thích công cụ được gửi đến các ứng dụng MCP để mô tả rủi ro cơ bản của một công cụ nhất định. Hầu hết các ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng bạn có thể dùng chúng để quyết định thời điểm gửi lời nhắc xác nhận cho người dùng.

Cùng với chuỗi tiêu đề, các gợi ý boolean sau đây được xác định như sau:

  • readOnlyHint: Nếu đúng, công cụ sẽ không sửa đổi môi trường của công cụ. Mặc định: false.
  • destructiveHint: Nếu đúng, công cụ có thể thực hiện các hành động phá huỷ. Nếu là false, thì công cụ chỉ có thể thực hiện các thao tác bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần với cùng một đối số sẽ không có thêm tác động nào đến môi trường của công cụ. Mặc định: false.
  • openWorldHint: Nếu đúng, công cụ có thể tương tác với "thế giới mở" của các thực thể bên ngoài. Nếu là false, thì công cụ chỉ có thể tương tác với các thực thể nội bộ. Ví dụ: một công cụ tìm kiếm trên web sẽ là thế giới mở, trong khi một công cụ bộ nhớ sẽ không phải là thế giới mở.

Gợi ý phá huỷ: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌