Claude Web Search

Claude Web Search cho phép mô hình Claude hỗ trợ khả năng này tìm kiếm trên web khi trả lời và trả về khối kết quả cùng trích dẫn khi giao thức cho phép. Cách này phù hợp với tác vụ cần thông tin gần đây, kiểm tra nguồn hoặc tìm kiếm giới hạn theo trang.

AGTCloud có thể cung cấp khả năng Claude qua API tương thích Chat hoặc cấu trúc Anthropic Messages. Các trường bật tìm kiếm và cấu trúc trả về khác nhau; chọn API theo chi tiết mô hình hiện tại.

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

Luồng chính của AGTCloud được tài liệu cũ ghi nhận là thêm web_search_options vào yêu cầu 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ề quản lý trí tuệ nhân tạo và liệt kê nguồn."
      }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'

Văn bản thường được đọc từ Assistant Message; trích dẫn được trả dưới dạng Annotation có cấu trúc, liên kết hay văn bản phụ thuộc vào mô hình và API hiện tại. Không tự tạo trích dẫn khi không có căn cứ từ phản hồi.

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

Khi dùng API Messages hỗ trợ Claude Web Search gốc, công cụ tìm kiếm nằm trong tools. Ví dụ sau chỉ minh họa cấu trúc giao thức; thay loại công cụ bằng phiên bản được tài liệu mô hình hiện tại cung cấp:

{
  "model": "MODEL_ID",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Tìm các tin quan trọng hôm nay về quản lý trí tuệ nhân tạo và liệt kê nguồn."
    }
  ],
  "tools": [
    {
      "type": "WEB_SEARCH_TOOL_VERSION",
      "name": "web_search",
      "max_uses": 5
    }
  ]
}

Chỉ dùng max_uses, lọc tên miền, vị trí người dùng và lọc động khi phiên bản công cụ tương ứng hỗ trợ. Xem cấu trúc Messages và Content Block đầy đủ trong Anthropic Messages Reference.

Đọc kết quả tìm kiếm và trích dẫn

Phản hồi Messages gốc có thể chứa các loại Content Block sau:

• server_tool_use：Cho biết mô hình đã gọi công cụ tìm kiếm phía máy chủ.
• web_search_tool_result：Chứa kết quả tìm kiếm hoặc lỗi công cụ.
• text：Câu trả lời cuối cùng của mô hình cho người dùng.
• citations：Khi được phản hồi cung cấp, liên kết các đoạn trả lời với nguồn trang web.

Ứng dụng cần xử lý theo nhánh type, không ghép tất cả Content Blocks như chuỗi thông thường.

{
  "content": [
    {
      "type": "text",
      "text": "Theo kết quả truy xuất…",
      "citations": [
        {
          "type": "web_search_result_location",
          "url": "https://example.com/article",
          "title": "Tiêu đề nguồn"
        }
      ]
    }
  ]
}

Ví dụ minh họa rằng trích dẫn và văn bản thuộc cùng cấu trúc phản hồi; các trường thực tế theo phản hồi hiện tại và Messages Reference.

Tên miền, vị trí và lọc động

Khi phiên bản công cụ hỗ trợ, có thể sử dụng:

• allowed_domains：Chỉ cho phép các tên miền được chỉ định.
• blocked_domains：Loại trừ các tên miền được chỉ định; không cấu hình đồng thời với danh sách cho phép.
• user_location：Cung cấp thông tin địa phương như thành phố, khu vực, quốc gia và múi giờ.
• Lọc động: Cho phép tổ hợp công cụ được hỗ trợ lọc thêm kết quả tìm kiếm.

Các tùy chọn này ảnh hưởng đến phạm vi nguồn nhưng không bảo đảm nội dung web đúng. Nghiệp vụ rủi ro cao vẫn cần xác minh nguồn, thời gian và tính nhất quán giữa nhiều bên.

Phân biệt lỗi công cụ tìm kiếm và lỗi HTTP

Công cụ tìm kiếm thất bại không nhất thiết khiến toàn bộ yêu cầu HTTP thất bại. Phản hồi gốc có thể vẫn trả trạng thái thành công nhưng chứa đối tượng lỗi trong web_search_tool_result.

Khác biệt giữa tìm kiếm gốc và công cụ tùy chỉnh

Claude Web Search do mô hình hoặc công cụ tìm kiếm phía máy chủ thực thi. Với Tool Calling tùy chỉnh, ứng dụng gọi dịch vụ tìm kiếm riêng và gửi lại kết quả. Khi cần kiểm soát chỉ mục, quyền truy cập hoặc dữ liệu nội bộ, Tool Calling phù hợp hơn.

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

• Mô hình và giao thức hiện tại được xác nhận hỗ trợ các trường Web Search đang dùng.
• Phiên bản loại công cụ lấy từ tài liệu hiện tại, không từ ví dụ mô hình cũ.
• Content Block, kết quả tìm kiếm, văn bản và trích dẫn được phân tích riêng.
• Lỗi công cụ không bị coi là kết quả tìm kiếm bình thường.
• Chỉ gửi dữ liệu tên miền và vị trí khi nghiệp vụ cần.
• Nội dung tìm kiếm không trực tiếp kích hoạt công cụ rủi ro cao hoặc bỏ qua cấp quyền.

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