Ghi danh agent

Thêm Onboard (AEP) vào dịch vụ của bạn. Agent ghi danh với tư cách khách hàng được nhận biết, có chủ sở hữu đã xác minh. Bạn chọn thông tin danh tính (claim) nào là bắt buộc, ưu tiên hoặc tùy chọn. Mỗi agent đã ghi danh nhận credential riêng để truy cập liên tục, theo các chính sách của dịch vụ bạn. Để xây dựng phần này với coding agent, xem Xây dựng với coding agent.

InFlow kiểm tra gì

InFlow kiểm tra địa chỉ email của mỗi chủ sở hữu bằng một email xác minh. InFlow kiểm tra số điện thoại của chủ sở hữu bằng một mã dùng một lần. Khi một agent InFlow ghi danh, InFlow yêu cầu chủ sở hữu phê duyệt. Agent không thể tự ghi danh.

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

Cài đặt phần service của SDK AEP cho ngôn ngữ của bạn.

Ngôn ngữ	Repository	Cài đặt cho một dịch vụ
Go	`aep-go`	`go get github.com/aep-foundation/aep-go@latest`. Import package `service`.
Java	`aep-java`	`foundation.aep:aep-service` và một JSON provider. Java 17 trở lên.
Node.js và TypeScript	`aep-node`	`npm install @aep-foundation/service`
Python	`aep-python`	`pip install agent-enrollment-protocol`. Import `agent_enrollment_protocol.service`. Python 3.11 trở lên.
Rust	`aep-rust`	`cargo add aep-service`

Trong Java, thêm đúng một JSON provider: aep-json-jackson2 hoặc aep-json-jackson3. Để kết nối SDK với web framework của bạn, thêm một adapter.

Ngôn ngữ	Adapter
Java	`aep-httpserver`, `aep-servlet`, `aep-spring-webmvc`
Node.js và TypeScript	`@aep-foundation/express`, `@aep-foundation/fastify`, `@aep-foundation/hono`, `@aep-foundation/next`
Rust	`aep-axum`, `aep-tower`

Tham khảo SDK liệt kê các package cho agent và platform.

Bước 2: Xuất bản tài liệu ghi danh

Cung cấp tài liệu ghi danh của bạn tại /.well-known/aep trên origin của bạn. Tài liệu này cho agent biết cách ghi danh, các claim bạn yêu cầu và các loại credential mà dịch vụ của bạn cấp. Các loại credential là các grant, ví dụ API key, xác thực Basic hoặc bearer token OAuth. Header xác thực cơ sở là Authorization: AEP <jwt>. Triển khai mỗi lệnh mà tài liệu công bố. Chỉ công bố các lệnh và phương thức mà bạn triển khai. Về định dạng tài liệu và các quy tắc chuẩn tắc, xem Cách Onboard hoạt động.

Bước 3: Giữ các quyền của bạn

Ghi danh thêm một cách để agent có quyền truy cập. Ghi danh không thay thế các quy tắc truy cập của bạn.

Giữ các quyền hiện có của ứng dụng.
Yêu cầu xác thực trên mỗi operation được bảo vệ.
Yêu cầu xác thực trên một operation có thu phí khi operation đó cần tài khoản.

Bước 4: Kết hợp ghi danh với thanh toán

Agent đã ghi danh thanh toán qua MPP hoặc x402. Ví dụ mpp-aep-seller-express trong các SDK Node của InFlow đặt bước ghi danh trước một endpoint MPP. Xem Tham khảo SDK.

Bước 5: Kiểm tra ghi danh

Chạy dịch vụ của bạn. Đăng nhập bằng inflow auth login. Đảm bảo vault ở trạng thái mở khóa. Sau đó ghi danh như một agent.

inflow aep inspect https://api.example.com
inflow aep enroll https://api.example.com --interval 5
inflow aep fetch https://api.example.com/protected
inflow aep status https://api.example.com

Lệnh	Kiểm tra
`aep inspect`	Lệnh này đọc tài liệu ghi danh của bạn mà không cần xác thực. Xác nhận rằng lệnh này liệt kê các lệnh và các loại credential mà bạn triển khai.
`aep enroll`	Lệnh này ghi danh agent. Phê duyệt lần ghi danh khi CLI hiện URL phê duyệt.
`aep fetch`	Lệnh này gọi một resource được bảo vệ. Khi dịch vụ của bạn gửi challenge cho request, lệnh này xác thực bằng credential ghi danh. Xác nhận rằng response đúng.
`aep status`	Lệnh này hiện trạng thái vòng đời của lần ghi danh.

Xem Tìm và ghi danh với dịch vụ để biết mọi flag.

Bước tiếp theo

Nhận biết khách hàng InFlow

Tìm ra agent đã ghi danh nào đến từ InFlow.

Bắt đầu

Nhận thanh toán

Nhận biết khách hàng

Được tìm thấy

Xuất bản