Làm cho agent của bạn có thể được khám phá
Một Agent Card rõ ràng cho client A2A một điểm khởi đầu đáng tin cậy: agent thuộc về ai, nó sống ở đâu, và nó nói giao thức binding và phiên bản nào.
Trình tạo Agent Card tạo ra gì cho agent AI của bạn
Agent Card là mô tả interface công khai của một agent A2A. Trước khi một agent khác có thể quyết định có gọi dịch vụ của bạn hay không, nó cần nhiều hơn một URL: nó cần một mô tả đáng tin cậy về mục đích, hợp đồng kỹ thuật, skill và yêu cầu truy cập của agent.
Trình tạo Agent Card này chuyển các chi tiết triển khai đó thành JSON dễ đọc theo định dạng A2A v1.0, trong khi vẫn giữ việc ra quyết định gần với biểu mẫu. Sử dụng nó sau khi bạn đã xây dựng logic cốt lõi của agent và trước khi triển khai hoặc niêm yết nó — điểm mà một tệp JSON viết tay thường bị lỗi.
Mô tả một interface có thể sử dụng
Ghi lại interface ưu tiên, các chế độ nội dung, hành vi streaming, và hỗ trợ thông báo đẩy mà agent khác cần trước khi thực hiện lệnh gọi.
Đặt kỳ vọng cho quyền truy cập
Ghi lại xem dịch vụ có công khai không, sử dụng khóa API, hay yêu cầu OAuth 2.0, để các tích hợp có thể chọn luồng xác thực đúng — mà không bao giờ đặt thông tin xác thực vào Agent Card.
Biến skill thành hợp đồng rõ ràng
Đặt tên cho công việc mà agent của bạn có thể thực hiện, thêm các tag mà v1.0 yêu cầu cùng các ví dụ hữu ích, và làm cho ranh giới của nó dễ hiểu đối với con người, marketplace, và client AI.
Cách Trình tạo Agent Card hoạt động
Từ chi tiết dịch vụ đến một Agent Card có thể xuất bản
Trình tạo Agent Card chuyển chi tiết dịch vụ thành một tài liệu JSON rõ ràng, có thể xuất bản. Làm theo quy trình ngắn này trước khi gửi Agent Card lên production.
- 1
Bắt đầu với dịch vụ thực
Thêm endpoint A2A công khai, giao thức binding, chi tiết provider, phiên bản agent, và các loại nội dung mà server của bạn chấp nhận và trả về.
- 2
Xác định ranh giới capability và skill
Chỉ chọn các capability mà triển khai của bạn hỗ trợ, sau đó mô tả một skill tiêu biểu bằng ngôn ngữ đơn giản, cụ thể.
- 3
Xem lại JSON đã tạo
Sử dụng xem trước trực tiếp để phát hiện các trường bị thiếu, URL giữ chỗ, hoặc mô tả không phản ánh chính xác dịch vụ đã triển khai.
- 4
Xác thực và xuất bản
Đưa Agent Card qua trình kiểm định, sau đó đặt tài liệu đã xem xét tại /.well-known/agent-card.json trên tên miền dịch vụ của bạn.
Ai sử dụng Trình tạo Agent Card
Được xây dựng cho mọi người tạo, phát hành, hoặc xem xét Agent Card
Trình tạo Agent Card giúp các nhà xây dựng, đội nền tảng, và người xem xét tạo metadata agent A2A nhất quán mà không cần bắt đầu từ một tệp JSON trống.
Nhà phát triển AI và độc lập
Thay thế một agent-card.json viết tay bằng một điểm khởi đầu hoàn chỉnh, đúng đặc tả khi ra mắt một agent tương thích A2A.
Kỹ sư prompt và quản lý sản phẩm
Soạn thảo một tài liệu khám phá đáng tin cậy từ mô tả dịch vụ mà không chạm vào cú pháp JSON, sau đó chuyển cho kỹ thuật xem xét.
Đội nền tảng và DevOps
Chuẩn hóa cách các agent nội bộ mô tả endpoint, xác thực, và skill trước khi chúng vào danh mục agent của công ty hoặc pipeline CI.
Nhà xuất bản marketplace
Chuẩn bị metadata provider, tag skill, và tuyên bố bảo mật mà người xem xét và hệ thống xếp hạng thực sự có thể phân tích.
Câu hỏi thường gặp
Câu hỏi về trình tạo Agent Card
Đảm bảo những điều cơ bản đúng trước khi client A2A tìm thấy endpoint của bạn.
A2A Agent Card là gì?
A2A Agent Card là một tài liệu khám phá JSON cho một agent AI. Nó truyền đạt danh tính, thông tin provider, interface được hỗ trợ, capability, skill, chế độ nội dung được chấp nhận, và yêu cầu bảo mật cho các client tiềm năng — tương đương agent-với-agent của một README cộng với tổng quan API.
Tại sao dùng trình tạo Agent Card thay vì viết JSON bằng tay?
Các Agent Card viết tay thường xuyên thiếu các trường bắt buộc, tên trường trước v1.0, hoặc lỗi cú pháp. Trình tạo tạo ra cấu trúc A2A v1.0 hiện tại — supportedInterfaces, provider.organization, tag skill bắt buộc — và xác thực khi bạn gõ, vì vậy lỗi cấu trúc không bao giờ đến được production.
Agent Card được tạo nhắm đến phiên bản A2A nào?
Trình tạo phát ra cấu trúc A2A v1.0: một mảng supportedInterfaces có thứ tự với protocolBinding và protocolVersion cho từng interface, một version agent cấp cao nhất, và capability bao gồm extendedAgentCard. Agent Card có trường url hoặc preferredTransport cấp cao nhất là trước v1.0.
JSON được tạo có cần xem xét trước khi đưa vào production không?
Có. Trình tạo tạo ra một tài liệu khởi đầu thực tế, không phải thay thế cho hợp đồng đã triển khai của bạn. Xác nhận rằng endpoint, giao thức binding, skill, và xác thực khớp với dịch vụ mà người dùng thực sự sẽ truy cập.
Tôi nên xuất bản Agent Card ở đâu?
Xuất bản JSON đã xem xét trên cùng tên miền với dịch vụ A2A của bạn tại https://your-domain/.well-known/agent-card.json, đường dẫn well-known được đăng ký bởi đặc tả A2A. Nhiều tích hợp cũ hơn cũng kiểm tra /.well-known/agent.json, vì vậy phục vụ cả hai là một chiến lược chuyển đổi an toàn.
Sẵn sàng xuất bản
Quay lại Trình tạo Agent Card trước khi xuất bản.
Hoàn thiện chi tiết, xem lại JSON đã tạo, và sử dụng xác thực trực tiếp trước khi xuất bản Agent Card của bạn.