Qwen Web Search

Bật tìm kiếm trên web cho yêu cầu Qwen và xử lý đúng công cụ tìm kiếm cùng kết quả trích dẫn.

Qwen Web Search cho phép mô hình Qwen hỗ trợ khả năng này truy cập thông tin trên web và trả trích dẫn nguồn khi phản hồi cho phép. Cách này phù hợp với thời tiết, tin tức, cập nhật sản phẩm và tác vụ cần thông tin gần đây.

Tìm kiếm Qwen có thể được cung cấp qua trường mở rộng Chat, công cụ tích hợp Responses hoặc framework tìm kiếm gốc của mô hình. Cách bật và cấu trúc trích dẫn khác nhau; chọn theo chi tiết mô hình hiện tại.

API tìm kiếm cần được mô hình xác nhận hỗ trợ

Không suy ra từ tên dòng Qwen rằng enable_search, Responses Web Search hoặc lựa chọn công cụ tìm kiếm đều khả dụng. Kiểm tra mô hình và giao thức trong Danh mục mô hình.

Bật tìm kiếm qua Chat

Luồng chính Qwen Chat trong tài liệu cũ sử dụng enable_search:

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": "Thời tiết hôm nay ở Hàng Châu thế nào? Hãy cung cấp nguồn."
      }
    ],
    "enable_search": true
  }'

enable_search là trường mở rộng của mô hình hoặc kênh, không phải tham số chung của mọi mô hình Chat. Nếu kiểu SDK không có trường này, có thể dùng yêu cầu HTTP trực tiếp hoặc khả năng tham số mở rộng của SDK, theo tài liệu mô hình thực tế.

Sử dụng tìm kiếm tích hợp qua Responses

Khi mô hình hiện tại hỗ trợ Responses Web Search, có thể dùng cấu trúc công cụ tích hợp:

curl 'https://api.agtcloud.cn/v1/responses' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "MODEL_ID",
    "tools": [
      {
        "type": "web_search_preview"
      }
    ],
    "input": "Thời tiết hôm nay ở Hàng Châu thế nào? Hãy cung cấp nguồn."
  }'

Kết quả Responses có thể chứa web_search_call, Output Item văn bản và url_citation. Xem cấu trúc đầy đủ trong Responses Reference.

Lựa chọn công cụ tìm kiếm hoặc Provider

Framework tìm kiếm gốc của Qwen có thể hỗ trợ chọn các Provider tìm kiếm khác nhau. Cấu hình này thuộc khả năng của mô hình, framework Agent hoặc kênh cụ thể, không phải trường thống nhất của AGTCloud Chat.

Khi tài liệu mô hình hiện tại xác nhận có tùy chọn Provider:

Sử dụng Provider mặc định có thể giảm cấu hình và giữ khả năng chuyển phương án dự phòng phía máy chủ.
Chỉ định Provider phù hợp với trường hợp có yêu cầu rõ về phạm vi nguồn, chất lượng truy xuất hoặc giới hạn tuân thủ.
Thông tin xác thực và quyền của Provider phải được lưu phía máy chủ, không đặt trong Prompt hoặc mã trình duyệt.
Việc tự động chuyển đổi khi Provider không khả dụng phụ thuộc vào triển khai công cụ hiện tại; ứng dụng vẫn phải xử lý thất bại.

Không coi tên công cụ tìm kiếm và thứ tự mặc định trong tài liệu cũ là cam kết dài hạn của nền tảng.

Đọc câu trả lời và trích dẫn

Các API khác nhau có thể trả về:

API	Câu trả lời	Trích dẫn
Mở rộng Chat	`choices[].message.content`	Annotation, liên kết hoặc nguồn đánh số được phản hồi cung cấp
Responses	Message Output Item	`url_citation` trong `annotations`
Framework tìm kiếm gốc	Câu trả lời do framework tạo	Danh sách nguồn đánh số hoặc đối tượng nguồn do Provider trả về

Nếu văn bản trả lời dùng số như [1], [2], ứng dụng phải lấy URL nguồn tương ứng; không chỉ hiển thị số không có liên kết đích.

{
  "answer": "Dự báo hôm nay Hàng Châu có mưa rào.[1]",
  "sources": [
    {
      "index": 1,
      "title": "Tiêu đề nguồn",
      "url": "https://example.com/weather"
    }
  ]
}

Ví dụ này biểu diễn dữ liệu hiển thị mà ứng dụng có thể tổng hợp nội bộ, không phải Schema phản hồi cố định của API AGTCloud.

Tìm kiếm gốc và hàm tùy chỉnh

Web Search tích hợp phục vụ thông tin trên web công khai. Khi cần truy vấn tìm kiếm nội bộ doanh nghiệp, đơn hàng hoặc kho kiến thức riêng, dùng Tool Calling để gọi dịch vụ có kiểm soát của bạn.

Văn bản do công cụ tùy chỉnh trả về không tự động có Citation đáng tin cậy. Ứng dụng cần trả kèm metadata nguồn và giữ liên kết giữa câu trả lời với nguồn trên giao diện cuối cùng.

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

Hiện tượng	Cách xử lý
`enable_search` bị từ chối	Kiểm tra mô hình và kênh hỗ trợ trường mở rộng, hoặc chọn API Responses đã được đăng ký
Tìm kiếm không được kích hoạt	Kiểm tra câu hỏi có cần thông tin gần đây không và trường bật tìm kiếm đã thực sự được gửi đến thượng nguồn
Số trích dẫn không có URL nguồn	Không hiển thị dưới dạng trích dẫn có thể nhấp; thông báo phản hồi thiếu thông tin nguồn đầy đủ
Provider không khả dụng	Chuyển đổi hoặc thử lại có giới hạn theo quy tắc công cụ; không lặp vô hạn qua các Provider
Kết quả tìm kiếm mâu thuẫn	Hiển thị nguồn và ngày; không để mô hình che giấu khác biệt quan trọng thay ứng dụng

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

Mô hình hiện tại được xác nhận hỗ trợ enable_search hoặc công cụ Responses đã chọn.
SDK không âm thầm loại bỏ trường mở rộng của mô hình.
Kết quả tìm kiếm Chat, Responses và gốc dùng các bộ phân tích riêng.
Số trích dẫn ánh xạ được đến tiêu đề và URL thực.
Cấu hình và thông tin xác thực Provider không nằm trong Prompt phía ứng dụng.
Không có kết quả, tìm kiếm thất bại và thiếu nguồn đều có phương án dự phòng rõ ràng.

Xem các trường chung của Chat trong Chat Completions Reference; khi yêu cầu thất bại, xem Lỗi và khắc phục sự cố.