MCP Tools Reference: developerknowledge.googleapis.com

Công cụ: answer_query

Sử dụng answer_query để nhận câu trả lời khái niệm tổng hợp, có căn cứ cho một câu hỏi cấp cao về các sản phẩm dành cho nhà phát triển của Google. Đối với các mã mẫu chính xác, cờ CLI, thông báo lỗi cụ thể hoặc hướng dẫn đầy đủ về tài liệu, hãy ưu tiên search_documents, sau đó là get_documents. Công cụ này có hạn mức hạn chế. 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 truy vấn. answer_query dựa trên câu trả lời bằng cách sử dụng cùng một kho dữ liệu với search_documents. Công cụ này trả về answer_text được tạo và danh sách tên tài liệu (tham chiếu) được dùng để tạo câu trả lời. Luôn trích dẫn tên tài liệu nguồn có thẩm quyền từ references (documents/...) trong câu trả lời cuối cùng cho người dùng. Sử dụng get_documents với tên tài liệu từ references để 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ụ MCP answer_query.

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

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

Thông báo yêu cầu cho AnswerQuery.

AnswerQueryRequest

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

string

Bắt buộc. Câu hỏi cần trả lời.

Giản đồ đầu ra

Tin nhắn 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 câu hỏi.
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 (ví dụ: documents/docs.cloud.google.com/storage/docs/creating-buckets). Trích dẫn các tên tài nguyên này trong câu trả lời cuối cùng và chuyển chúng đến get_documents nếu cần toàn bộ nội dung 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ở: ❌