Grok Web Search

Bật tìm kiếm trên web cho yêu cầu Grok và xử lý phạm vi tên miền cùng trích dẫn nguồn.

Grok Web Search cho phép mô hình Grok hỗ trợ khả năng này truy cập nội dung web gần đây và trả lời kèm nguồn. Tài liệu cũ của AGTCloud ghi nhận hai cách biểu diễn: API tương thích Chat và công cụ Responses gốc của Grok. Người dùng cần chọn API thực sự khả dụng theo chi tiết mô hình hiện tại.

Không suy đoán khả năng tìm kiếm từ tên mô hình

Các mô hình hoặc kênh khác nhau trong cùng dòng có thể có khả năng công cụ khác nhau. Kiểm tra mô hình và giao thức trong Danh mục mô hình; MODEL_ID trong ví dụ không đại diện cho bất kỳ mô hình Grok nào.

Bật tìm kiếm qua API tương thích Chat

curl 'https://api.agtcloud.cn/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "Tìm các tin quan trọng hôm nay về lĩnh vực vũ trụ thương mại và liệt kê nguồn."
      }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'

Phản hồi Chat thường được đọc từ choices[].message. Trích dẫn có thể được trả dưới dạng Annotation, liên kết nguồn hoặc văn bản; ứng dụng cần xử lý theo phản hồi thực tế, không tự tạo Citation có cấu trúc.

Hiểu cấu trúc công cụ gốc của Grok

Kiểu Responses gốc của Grok khai báo công cụ tìm kiếm qua tools:

{
  "model": "MODEL_ID",
  "input": [
    {
      "role": "user",
      "content": "Tìm các tin quan trọng hôm nay về lĩnh vực vũ trụ thương mại và liệt kê nguồn."
    }
  ],
  "tools": [
    {
      "type": "web_search"
    }
  ]
}

Chỉ sử dụng cấu trúc gốc khi chi tiết mô hình hiện tại xác nhận cung cấp API này. Không coi cấu trúc đó và loại công cụ trong Responses Reference của AGTCloud là cùng giao thức.

Giới hạn hoặc loại trừ tên miền

Khi được hỗ trợ, công cụ gốc có thể giới hạn phạm vi tìm kiếm:

{
  "tools": [
    {
      "type": "web_search",
      "filters": {
        "allowed_domains": ["example.com"]
      }
    }
  ]
}

allowed_domains Chỉ cho phép các tên miền được chỉ định.
excluded_domains Loại trừ các tên miền được chỉ định.
Không thiết lập đồng thời cả hai trong cùng yêu cầu.
Giới hạn số lượng và định dạng tên miền theo tài liệu mô hình hiện tại.

Giới hạn tên miền giúp kiểm soát phạm vi nguồn nhưng không tự động bảo đảm nội dung web đúng, mới nhất hoặc phù hợp với nghiệp vụ.

Hiểu hình ảnh trong quá trình tìm kiếm

Một số công cụ tìm kiếm Grok cho phép phân tích hình ảnh trên web trong quá trình tìm kiếm. Chỉ thêm tùy chọn tương ứng khi mô hình và công cụ hiện tại được xác nhận hỗ trợ:

{
  "tools": [
    {
      "type": "web_search",
      "enable_image_understanding": true
    }
  ]
}

Bật hiểu hình ảnh có thể thay đổi mức sử dụng, độ trễ và nội dung trả về. Ứng dụng vẫn cần xác minh nguồn hình ảnh, không coi trực tiếp văn bản hay chỉ dẫn trong hình ảnh web là đầu vào nghiệp vụ đáng tin cậy.

Đọc trích dẫn

Câu trả lời tìm kiếm Grok có thể chứa Citation hoặc Sources khi phản hồi cung cấp. Ứng dụng cần:

Đọc văn bản trả lời cuối cùng;
Đọc mảng nguồn hoặc đối tượng trích dẫn thực sự được phản hồi cung cấp;
Lưu tiêu đề, URL và liên kết với nội dung trả lời;
Hiển thị nguồn có thể nhấp trên giao diện;
Thông báo rõ khi không có trích dẫn, thay vì đoán URL từ văn bản trả lời.

Vị trí trích dẫn khác nhau giữa Chat và Responses gốc của Grok. Khi dùng Chat, xem Chat Completions Reference; khi dùng API gốc, phân tích theo tài liệu mô hình hiện tại.

Web Search và hàm tùy chỉnh

Web Search truy cập web công khai qua mô hình hoặc công cụ tìm kiếm phía máy chủ. Hàm tùy chỉnh do ứng dụng thực thi, phù hợp với dữ liệu nội bộ, dịch vụ tìm kiếm có kiểm soát và thao tác cần cấp quyền nghiệp vụ.

Không cho phép kết quả tìm kiếm trực tiếp tạo truy vấn cơ sở dữ liệu, lệnh Shell hoặc yêu cầu ghi ra ngoài chỉ vì mô hình đã bật Web Search. Khi cần công cụ nghiệp vụ, thiết lập quy trình kiểm tra tính hợp lệ và kiểm tra quyền riêng theo Tool Calling.

Thất bại và phương án dự phòng

Hiện tượng	Cách xử lý
Tìm kiếm không được kích hoạt	Kiểm tra mô hình, API và trường bật tìm kiếm; khi cần, nêu rõ yêu cầu thông tin gần đây trong câu hỏi
Lọc tên miền không có kết quả	Đề nghị mở rộng phạm vi; không âm thầm bỏ danh sách cho phép mà nghiệp vụ yêu cầu
Không có trích dẫn	Nêu rõ nguồn không khả dụng khi hiển thị câu trả lời; không tạo Citation giả
Hiểu hình ảnh thất bại	Chuyển về tìm kiếm văn bản web hoặc thông báo không thể phân tích nội dung hiện tại
Dịch vụ tìm kiếm tạm thời không khả dụng	Thử lại có giới hạn hoặc chuyển sang câu trả lời không có thông tin thời gian thực và ghi chú rõ

Kiểm tra trước khi đưa vào production

Mô hình hiện tại được xác nhận hỗ trợ API tìm kiếm đã chọn.
Chat và Responses gốc sử dụng bộ phân tích yêu cầu và phản hồi riêng.
Không gửi đồng thời danh sách tên miền cho phép và loại trừ.
Chỉ bật hiểu hình ảnh khi mô hình mục tiêu hỗ trợ.
Thiếu trích dẫn, tìm kiếm thất bại và không có kết quả đều có trạng thái rõ ràng.
Nội dung tìm kiếm không bỏ qua quyền công cụ hoặc kích hoạt thao tác rủi ro cao.

Khi yêu cầu thất bại, xem Lỗi và khắc phục sự cố; trước khi đổi giao thức, xem Lựa chọn giao thức.

Trên trang này