Chuyển đến nội dung chính
Thêm Discover (ODP) vào dịch vụ của bạn. Listing của bạn liên kết đến danh mục của chính bạn, nên giá vẫn do bạn kiểm soát. Agent tìm sản phẩm của bạn, đọc chi tiết cùng giá của sản phẩm và tìm các action để dùng hoặc mua sản phẩm. Bắt đầu từ chức năng hiện có của ứng dụng, không bắt đầu từ một ví dụ SDK. Dùng dữ liệu thật của ứng dụng cho mọi offering. Để xây dựng phần này với coding agent, xem Xây dựng với coding agent.

Bước 1: Cài đặt SDK

Cài đặt phần service của SDK ODP cho ngôn ngữ của bạn. Trong Java, thêm đúng một JSON provider: odp-json-jackson2 hoặc odp-json-jackson3. Tham khảo SDK liệt kê các package cho agent và cho tìm kiếm directory.

Bước 2: Chọn một mức

Nếu không có tìm kiếm, agent phải liệt kê toàn bộ danh mục của bạn để tìm một sản phẩm.

Bước 3: Mô tả offering và action

Một offering là một sản phẩm. Một action là một operation mà agent có thể làm trên offering đó, ví dụ một lần mua. Cung cấp cho mỗi offering:
  • Một tên và mô tả rõ ràng.
  • Giá và loại tiền.
  • Các action để dùng hoặc mua offering đó.
Mô tả endpoint của mỗi action theo cách endpoint đó hiện hoạt động, kèm hành vi xác thực và thanh toán của endpoint. Nếu endpoint cần ghi danh, nêu rõ điều đó. Nếu endpoint cần thanh toán, giá trong listing của bạn phải khớp với giá trong challenge 402 của endpoint. Nhóm các offering liên quan vào collection, để agent có thể duyệt qua một danh mục lớn.

Trả về liên kết next dùng được

Mọi operation liệt kê và tìm kiếm trả về các trang. Khi còn thêm mục, trang phải chứa next. Trang cuối phải bỏ next. next phải là một URL mà agent có thể gọi bằng GET. URL này phải phân giải về cùng origin với request đầu tiên. Không trả về cursor thuần. Giá trị đúng chỉ là một ví dụ. Dùng cơ chế tiếp nối của riêng bạn. Giữ ngữ cảnh request trong liên kết: dạng biểu diễn, bộ lọc, từ khóa tìm kiếm, thứ tự sắp xếp và kích thước trang. Agent đi theo next nguyên trạng, không giải mã cursor và không tạo URL.
Nếu next không phải là URL dùng được, các client khám phá từ chối toàn bộ trang. Khi đó directory không hiện bản xem trước collection hoặc offering nào cho dịch vụ của bạn. Không xóa next để sửa lỗi này, nếu không agent không nhận được các trang khác của bạn.
Kiểm thử mọi operation liệt kê mà bạn công bố, bao gồm các offering của mỗi collection. Đi theo từng liên kết next. Đảm bảo mỗi trang tiến lên, không có mục nào thiếu hoặc lặp lại và trang cuối không có next. Kiểm tra tính hợp lệ của mỗi trang theo các quy tắc phân trang của đặc tả khám phá.

Bước 4: Xuất bản tài liệu khám phá

Cung cấp tài liệu khám phá của bạn tại /.well-known/odp trên origin của bạn. Tài liệu này phải công khai. Chỉ khai báo các operation mà bạn triển khai. Về định dạng tài liệu và đặc tả, xem Cách Discover hoạt động.

Bước 5: Kiểm tra khám phá

Chạy dịch vụ của bạn. Sau đó đọc danh mục của bạn như một agent.
Kiểm tra mỗi offering có mô tả, giá, loại tiền và ít nhất một action. Sau đó so sánh mỗi giá niêm yết với khoản thu thực tế. resolve chuyển một action thành một request mà không gửi request đó. mpp inspect hoặc x402 inspect gửi request đó và hiện challenge 402. Cả hai lệnh đều không thanh toán.
Giá và loại tiền trong listing của bạn phải khớp với số tiền và loại tiền trong challenge. Sau khi thay đổi tài liệu khám phá, thêm --refresh vào inflow inspect để kiểm tra lại tính hợp lệ của các tài liệu công khai.

Niêm yết bằng tài liệu OpenAPI

Tài liệu khám phá là định dạng listing gốc của InFlow. Directory cũng chấp nhận một tài liệu OpenAPI 3.x dạng JSON. Khi đó agent đọc các operation của bạn bằng inflow openapi operations. Xem Xuất bản lên directory.

Bước tiếp theo

Chuyển sang production

Chuyển tích hợp đã kiểm thử sang production.
Lần sửa đổi cuối 31 tháng 10, 2026