MCP Tools Reference: developerknowledge.googleapis.com

Công cụ: search_documents

Sử 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. Công cụ này bao gồm 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

  • Firebase: firebase.google.com

  • Fuchsia: fuchsia.dev

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Cloud: docs.cloud.google.com

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

  • Google Home: developers.home.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 phù hợp. Nếu các đoạn văn bả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ẫu sau đây minh hoạ 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 vùng 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 truy vấn đã cho. Mỗi Tài liệu trong danh sách này chứa một đoạn nội dung có liên quan đến truy vấn tìm kiếm. Sử dụng trường DocumentChunk.name 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 mà đoạn này lấy từ đó. Đị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 giữa các tài liệu. Mã đ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 công cụ

Gợi ý mang tính phá hoại: ❌ | Gợi ý về tính luỹ đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌