MCP Tools Reference: developerknowledge.googleapis.com

Công cụ: answer_query

Sử dụng answer_query để nhận được câu trả lời có căn cứ cho một câu hỏi về các sản phẩm của Google dành cho nhà phát triển. Công cụ này có hạn mức giới hạn. Công cụ này sẽ tổng hợp thông tin từ kho dữ liệu để tạo câu trả lời cho câu hỏi. answer_query đưa ra câu trả lời dựa trên cùng một kho dữ liệu như search_documents. Công cụ này trả về answer_text đã tạo và danh sách tên tài liệu (references) được dùng để tạo câu trả lời. Sử dụng get_documents cùng với tên tài liệu để tìm nạp toàn bộ nội dung tài liệu nếu cần.

Nếu bạn gặp lỗi 429 vượt quá hạn mức, hãy sử dụng search_documents.

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ answer_query 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": "answer_query",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

Yêu cầu quyền truy cập vào thư từ AnswerQuery.

AnswerQueryRequest

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

string

Bắt buộc. Cụm từ tìm kiếm cần trả lời.

Giản đồ đầu ra

Thông báo phản hồi cho AnswerQuery.

AnswerQueryResponse

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

string

Câu trả lời cho truy vấn.
references[]

string

Chỉ có đầu ra. Tên tài nguyên của các tài liệu được dùng để tạo câu trả lời.

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