OpenAI Web Search

OpenAI Web Search cho phép mô hình hỗ trợ khả năng này tìm kiếm trên web trước khi trả lời, rồi trả về văn bản, lời gọi tìm kiếm và trích dẫn nguồn. Cách này phù hợp với tin tức, thời tiết, cập nhật sản phẩm và các truy vấn có tính thời sự rõ rệt.

Nếu dữ liệu đến từ cơ sở dữ liệu hoặc dịch vụ nghiệp vụ của bạn, hãy dùng Tool Calling để định nghĩa công cụ có kiểm soát, thay vì đưa dữ liệu nội bộ vào tìm kiếm trên web công khai.

Chọn Responses hoặc Chat

Responses phù hợp hơn với ứng dụng cần phân biệt lời gọi tìm kiếm, câu trả lời và nguồn; Chat phù hợp với dự án đã sử dụng cấu trúc thông điệp.

Tìm kiếm trên web bằng Responses

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",
        "search_context_size": "medium"
      }
    ],
    "input": "Hôm nay có những tin công nghệ nào đáng chú ý?"
  }'

Mô hình có thể quyết định có tìm kiếm hay không dựa trên câu hỏi. Khi tìm kiếm diễn ra, output thường chứa cả mục lời gọi tìm kiếm và mục thông điệp văn bản; xem các loại Tool đầy đủ trong Responses Reference.

Sử dụng Chat Completions

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": "Hôm nay có những tin công nghệ nào đáng chú ý?"
      }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'

Văn bản phản hồi Chat nằm trong choices[].message.content; nếu phản hồi cung cấp trích dẫn có cấu trúc, chúng nằm trong choices[].message.annotations. Xem các trường đầy đủ trong Chat Completions Reference.

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

{
  "output": [
    {
      "type": "web_search_call",
      "id": "ws_example",
      "status": "completed"
    },
    {
      "type": "message",
      "content": [
        {
          "type": "output_text",
          "text": "Theo kết quả tìm kiếm…",
          "annotations": [
            {
              "type": "url_citation",
              "url": "https://example.com/article",
              "title": "Tiêu đề nguồn"
            }
          ]
        }
      ]
    }
  ]
}

Không chỉ lưu văn bản trả lời. Ứng dụng cần giữ URL, tiêu đề và liên kết giữa trích dẫn với vị trí trong văn bản, hiển thị nguồn có thể nhấp và sử dụng thuộc tính an toàn khi mở liên kết ngoài trong tab mới.

Giới hạn phạm vi tìm kiếm

Khi mô hình và API hỗ trợ, có thể cấu hình các điều kiện tìm kiếm sau:

• Phạm vi tên miền: Chỉ truy xuất từ trang được phép, phù hợp với nguồn y khoa, pháp luật hoặc kiến thức doanh nghiệp.
• Vị trí người dùng: Cung cấp quốc gia, thành phố, khu vực hoặc múi giờ để hỗ trợ trả kết quả theo địa phương.
• Kích thước ngữ cảnh tìm kiếm: Chọn phạm vi phù hợp để cân bằng chất lượng phản hồi, độ trễ và mức sử dụng.
• Danh sách nguồn: Khi được hỗ trợ, Responses có thể trả về các nguồn đã xem trong quá trình tìm kiếm, không chỉ các nguồn được trích dẫn trong câu trả lời cuối cùng.

Vị trí các trường khác nhau giữa Responses và Chat; tên cụ thể và giới hạn theo Reference tương ứng.

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

Nội dung trang web ngoài có thể chứa thông tin sai hoặc chỉ dẫn độc hại nhắm vào mô hình. Không tự động tin tưởng chỉ vì nội dung đến từ kết quả tìm kiếm, và không cho nội dung đó bỏ qua quyền của ứng dụng hay kích hoạt công cụ rủi ro cao.

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

• Mô hình và giao thức được xác nhận hỗ trợ Web Search.
• Câu trả lời, lời gọi tìm kiếm, trích dẫn và danh sách nguồn được phân tích riêng.
• Không tạo liên kết giả khi không có trích dẫn.
• Chỉ gửi thông tin tên miền và vị trí khi nghiệp vụ cần.
• Nội dung ngoài không bỏ qua quy trình kiểm tra quyền và xác nhận của Tool Calling.
• Tìm kiếm thất bại, hết thời gian chờ và không có kết quả đều có phương án dự phòng rõ ràng.

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.