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ừ lệnh gọi đến công cụ search_documents hoặc trường references do công cụ answer_query trả về. Đặt tham số names thành danh sách tên tài liệu (documents/...) và trích dẫn các tài liệu nguồn có căn cứ được dùng trong câu trả lời cuối cùng.

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

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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Lược đồ đầu vào

Yêu cầu giản đồ 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 tài liệu cần truy xuất, do trường parent của kết quả search_documents hoặc trường references của answer_query trả về. Bạn có thể truy xuất tối đa 20 tài liệu trong một lệnh gọi. Tài liệu được trả về theo cùng thứ tự với 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)

Đã yêu cầu tài liệ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ả tài liệu.
title

string

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

Chú thích về công cụ

Chú thích về công cụ được gửi đến ứ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 ứng dụng đều coi những gợi ý này là không đáng tin cậy, nhưng chúng có thể được dù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 nó. Mặc định: false.
  • destructiveHint: Nếu đúng, thì công cụ có thể thực hiện các hành động có tính huỷ diệt. Nếu là false, thì công cụ chỉ có thể thực hiện các hành động bổ sung. Mặc định: true.
  • idempotentHint: Nếu đúng, thì việc gọi công cụ nhiều lần bằng cùng một đối số sẽ không có thêm hiệu ứng nào đối với môi trường của công cụ đó. Mặc định: false.
  • openWorldHint: Nếu đúng, thì công cụ này 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ụ: công cụ tìm kiếm trên web sẽ là công cụ thế giới mở, còn công cụ ghi nhớ sẽ không phải là công cụ thế giới mở.

Gợi ý về hành động huỷ diệt: ❌ | Gợi ý về hành động luỹ đẳng: ✅ | Gợi ý về hành động chỉ đọc: ✅ | Gợi ý về hành động thế giới mở: ❌