MCP Tools Reference: developerknowledge.googleapis.com

Công cụ: search_documents

Hãy dùng công cụ này để tìm tài liệu về các sản phẩm của Google Developers. Tài liệu này chứa các API chính thức, đoạn mã, ghi chú phát hành, các phương pháp hay nhất, hướng dẫn, thông tin gỡ lỗi, v.v. Chính sách này áp dụng cho các sản phẩm và miền sau:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Gemini CLI: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • AI của Google: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com và docs.cloud.google.com

  • Google Developers, Google Ads, Google Tìm kiếm, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Công cụ này trả về các đoạn văn bản, tên và URI cho các tài liệu phù hợp. Ưu tiên search_documents, sau đó là get_documents khi bạn cần mã mẫu chính xác, cờ CLI, thông báo lỗi cụ thể, hướng dẫn đầy đủ hoặc tra cứu từ khoá tất định. Nếu các đoạn được trả về không đủ chi tiết để trả lời câu hỏi của người dùng, hãy sử dụng get_documents với parent từ kết quả của công cụ này để truy xuất toàn bộ nội dung tài liệu. Khi trả lời người dùng, hãy luôn trích dẫn tên tài nguyên (documents/...) hoặc URI của tài liệu nguồn có căn cứ đáng tin.

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ MCP search_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": "search_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 search_documents. Sử dụng trường query để tìm tài liệu liên quan dành cho nhà phát triển của Google.

SearchDocumentChunksRequest

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

string

Bắt buộc. Chuỗi truy vấn thô do người dùng cung cấp, chẳng hạn như "Làm cách nào để tạo bộ chứa Cloud Storage?".

Giản đồ đầu ra

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

SearchDocumentChunksResponse

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

object (DocumentChunk)

Kết quả tìm kiếm cho cụm từ tìm kiếm đã cho. Mỗi DocumentChunk trong danh sách này chứa một trích đoạn nội dung liên quan đến cụm từ tìm kiếm. Sử dụng trường DocumentChunk.parent của mỗi kết quả với get_documents để truy xuất toàn bộ nội dung tài liệu.

DocumentChunk

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

string

Chỉ có đầu ra. Tên tài nguyên của tài liệu chứa đoạn này. Định dạng: documents/{uri_without_scheme} Ví dụ: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

Chỉ có đầu ra. Mã của đoạn này trong tài liệu. Mã đoạn là duy nhất trong một tài liệu, nhưng không phải là duy nhất trên toàn cầu trong các tài liệu. Mã phân đoạn không ổn định và có thể thay đổi theo thời gian.
content

string

Chỉ có đầu ra. Nội dung của đoạn 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ở: ❌