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 dành cho nhà phát triển của Google. Các tài liệu này chứa 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à nhiều nội dung khác. Chương trình 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

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

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

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

  • Google Home: developers.home.google.com

  • Nền tảng Google Maps: mapsplatform.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à URL cho các tài liệu trùng khớp. 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ừ đầu ra của công cụ này để truy xuất toàn bộ nội dung tài liệu.

Mã mẫu sau đây cho biết cách sử dụng curl để gọi công cụ search_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": "search_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 search_documents. Sử dụng trường truy vấn để 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ư "Cách tạo một vùng lưu trữ Cloud Storage".

Giản đồ đầu ra

Lược đồ 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 Tài liệu trong danh sách này đều chứa một đoạn nội dung liên quan đến cụm từ tìm kiếm. Sử dụng trường DocumentChunk.name của mỗi kết quả bằng 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 mà đoạn này thuộc về. Đị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ã nhận dạng đoạn là mã nhận dạng duy nhất trong một tài liệu, nhưng không phải là mã nhận dạng duy nhất trên toàn cầu giữa các tài liệu. Mã nhận dạng khối 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ú 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ở: ❌