Khám phá agent công khai
Sử dụng các ví dụ này để định hình JSON mà một client A2A khác lấy trước khi quyết định liệu agent của bạn có thể hoàn thành một nhiệm vụ hay không.
6 mẫu JSON sẵn sàng sao chép · A2A v1.0
Duyệt các mẫu A2A v1.0 thực tế, hiểu các quyết định thiết kế của chúng, sau đó điều chỉnh bất kỳ ví dụ nào cho agent của riêng bạn.
Sử dụng các ví dụ này để định hình JSON mà một client A2A khác lấy trước khi quyết định liệu agent của bạn có thể hoàn thành một nhiệm vụ hay không.
Điều chỉnh provider, skill, tag, capability, và metadata bảo mật để người đánh giá hiểu agent làm gì và ai vận hành nó.
Chuẩn hóa mô tả endpoint, xác thực, và skill giữa các agent nội bộ trước khi các đội tích hợp chúng vào quy trình làm việc.
Mẫu JSON
Xử lý câu hỏi về sản phẩm, tra cứu đơn hàng, hoàn trả, và chuyển giao khi cần leo thang.
Tại sao nó được xây dựng như vậy
{
"name": "Agent Hỗ trợ Khách hàng",
"description": "Trả lời các câu hỏi hỗ trợ khách hàng, truy xuất bối cảnh đơn hàng và chuyển các vấn đề chưa được giải quyết lên nhóm con người.",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/customer-support",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "Ví dụ Inc.",
"url": "https://example.com"
},
"version": "1.0.0",
"capabilities": {
"streaming": true,
"pushNotifications": true,
"extendedAgentCard": false
},
"defaultInputModes": [
"text/plain",
"application/json"
],
"defaultOutputModes": [
"text/plain",
"application/json"
],
"skills": [
{
"id": "resolve-customer-support-request",
"name": "Giải quyết yêu cầu hỗ trợ khách hàng",
"description": "Phân loại yêu cầu hỗ trợ khách hàng, thu thập bối cảnh cần thiết, đề xuất giải pháp và chuyển lên cấp cao hơn khi độ tin cậy thấp.",
"tags": [
"support",
"orders",
"returns"
],
"examples": [
"Hãy giúp tôi trả lại đơn hàng của tôi."
]
}
],
"securitySchemes": {
"oauth2": {
"oauth2SecurityScheme": {
"flows": {
"clientCredentials": {
"tokenUrl": "https://api.example.com/a2a/customer-support/oauth/token",
"scopes": {
"agent.invoke": "Invoke agent skills"
}
}
}
}
}
},
"security": [
{
"oauth2": [
"agent.invoke"
]
}
]
}Tìm các khung giờ hẹn có sẵn và chuẩn bị xác nhận đặt chỗ.
Tại sao nó được xây dựng như vậy
{
"name": "Agent Đặt chỗ",
"description": "Tìm kiếm tình trạng phòng trống, đề xuất các lựa chọn đặt chỗ và chuẩn bị đặt chỗ cuộc hẹn để phê duyệt.",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/booking",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "Ví dụ Inc.",
"url": "https://example.com"
},
"version": "1.0.0",
"capabilities": {
"streaming": false,
"pushNotifications": true,
"extendedAgentCard": false
},
"defaultInputModes": [
"text/plain",
"application/json"
],
"defaultOutputModes": [
"application/json"
],
"skills": [
{
"id": "find-and-prepare-booking",
"name": "Tìm và chuẩn bị đặt chỗ",
"description": "Kiểm tra tính khả dụng của tài nguyên, so sánh thời lượng đặt trước và trả về đề xuất đặt trước có cấu trúc.",
"tags": [
"booking",
"calendar",
"availability"
],
"examples": [
"Tìm một cuộc hẹn 30 phút vào chiều mai."
]
}
],
"securitySchemes": {
"apiKey": {
"apiKeySecurityScheme": {
"location": "header",
"name": "X-API-Key"
}
}
},
"security": [
{
"apiKey": []
}
]
}So sánh sản phẩm, tình trạng còn hàng, giá cả, và ràng buộc mua hàng.
Tại sao nó được xây dựng như vậy
{
"name": "Agent Mua sắm",
"description": "So sánh các sản phẩm với các ràng buộc của người dùng và trả về các tùy chọn mua hàng được xếp hạng với sự đánh đổi.",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/shopping",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "Ví dụ Inc.",
"url": "https://example.com"
},
"version": "1.0.0",
"capabilities": {
"streaming": true,
"pushNotifications": false,
"extendedAgentCard": false
},
"defaultInputModes": [
"text/plain",
"application/json"
],
"defaultOutputModes": [
"application/json"
],
"skills": [
{
"id": "compare-shopping-options",
"name": "So sánh các lựa chọn mua sắm",
"description": "Đánh giá các sản phẩm ứng viên, lọc theo ràng buộc và trả về các đề xuất được xếp hạng có lý do căn bản.",
"tags": [
"shopping",
"commerce",
"recommendations"
],
"examples": [
"So sánh máy tính xách tay nhẹ dưới 1.200 USD."
]
}
],
"securitySchemes": {
"oauth2": {
"oauth2SecurityScheme": {
"flows": {
"clientCredentials": {
"tokenUrl": "https://api.example.com/a2a/shopping/oauth/token",
"scopes": {
"agent.invoke": "Invoke agent skills"
}
}
}
}
}
},
"security": [
{
"oauth2": [
"agent.invoke"
]
}
]
}Xem xét các tác vụ code, đề xuất bản vá, và giải thích các quyết định triển khai.
Tại sao nó được xây dựng như vậy
{
"name": "Agent Lập trình",
"description": "Hỗ trợ các nhiệm vụ kỹ thuật phần mềm bằng cách phân tích mã, đề xuất thay đổi và gửi lại các ghi chú triển khai.",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/coding",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "Ví dụ Inc.",
"url": "https://example.com"
},
"version": "1.0.0",
"capabilities": {
"streaming": true,
"pushNotifications": true,
"extendedAgentCard": true
},
"defaultInputModes": [
"text/plain",
"application/json"
],
"defaultOutputModes": [
"text/plain",
"application/json"
],
"skills": [
{
"id": "implement-code-change",
"name": "Thực hiện thay đổi mã",
"description": "Đọc yêu cầu mã hóa, kiểm tra các tệp có liên quan, trả về đề xuất bản vá và tóm tắt các bước xác minh.",
"tags": [
"coding",
"review",
"patches"
],
"examples": [
"Thêm phân trang vào API người dùng."
]
}
],
"securitySchemes": {
"apiKey": {
"apiKeySecurityScheme": {
"location": "header",
"name": "X-API-Key"
}
}
},
"security": [
{
"apiKey": []
}
]
}Thu thập nguồn, trích xuất bằng chứng, và trả về ghi chú nghiên cứu có cấu trúc.
Tại sao nó được xây dựng như vậy
{
"name": "Agent Nghiên cứu",
"description": "Thu thập tài liệu nguồn, trích xuất bằng chứng và tạo ra các ghi chú nghiên cứu có cấu trúc kèm theo các trích dẫn.",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/research",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "Ví dụ Inc.",
"url": "https://example.com"
},
"version": "1.0.0",
"capabilities": {
"streaming": true,
"pushNotifications": false,
"extendedAgentCard": false
},
"defaultInputModes": [
"text/plain"
],
"defaultOutputModes": [
"text/plain",
"application/json"
],
"skills": [
{
"id": "prepare-research-brief",
"name": "Chuẩn bị tóm tắt nghiên cứu",
"description": "Tìm kiếm các nguồn đã được phê duyệt, trích xuất các tuyên bố và bằng chứng, đồng thời trả về bản tóm tắt nghiên cứu ngắn gọn.",
"tags": [
"research",
"evidence",
"citations"
],
"examples": [
"Chuẩn bị một bản tóm tắt được trích dẫn về chính sách năng lượng tái tạo."
]
}
]
}Điều phối phê duyệt, kiểm tra trạng thái, và cập nhật quy trình làm việc văn phòng.
Tại sao nó được xây dựng như vậy
{
"name": "Agent Quy trình Làm việc Nội bộ",
"description": "Điều phối các phê duyệt nội bộ, kiểm tra trạng thái hệ thống và chuẩn bị cập nhật quy trình làm việc cho các nhóm vận hành.",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/workflow",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "Ví dụ Inc.",
"url": "https://example.com"
},
"version": "1.0.0",
"capabilities": {
"streaming": false,
"pushNotifications": true,
"extendedAgentCard": true
},
"defaultInputModes": [
"application/json"
],
"defaultOutputModes": [
"application/json"
],
"skills": [
{
"id": "coordinate-internal-workflow",
"name": "Điều phối quy trình làm việc nội bộ",
"description": "Nhận ý định của quy trình làm việc, kiểm tra các yêu cầu chính sách, thu thập phê duyệt và báo cáo trạng thái cuối cùng.",
"tags": [
"workflow",
"operations",
"approval"
],
"examples": [
"Yêu cầu phê duyệt để triển khai bản cập nhật bảng lương."
]
}
],
"securitySchemes": {
"oauth2": {
"oauth2SecurityScheme": {
"flows": {
"clientCredentials": {
"tokenUrl": "https://api.example.com/a2a/workflow/oauth/token",
"scopes": {
"agent.invoke": "Invoke agent skills"
}
}
}
}
}
},
"security": [
{
"oauth2": [
"agent.invoke"
]
}
]
}Điều chỉnh một cách tự tin
Mỗi ví dụ Agent Card được cố ý hoàn chỉnh đủ để sao chép, nhưng Agent Card không nên được xuất bản mà không thay đổi. Hãy coi nó như một bản đồ trường cho server A2A của riêng bạn: thay thế danh tính, endpoint, provider, xác thực, capability, chế độ, và chi tiết skill bằng giá trị production.
Các Agent Card mạnh nhất giải thích ranh giới tác vụ của agent bằng cả ngôn ngữ đơn giản và metadata máy có thể đọc được. Một client nên có thể biết agent có thể làm gì, không thể làm gì, cần gọi URL nào, và có cần thông tin xác thực hay không.
Thay thế mọi URL example.com bằng endpoint A2A đã triển khai và trang web provider của bạn.
Viết lại tên skill, mô tả, tag (bắt buộc trong v1.0), và ví dụ cho ranh giới tác vụ thực tế.
Đặt provider.organization và tăng version cấp cao nhất bất cứ khi nào nội dung Agent Card thay đổi.
Chỉ xóa các trường xác thực khi endpoint được cố ý công khai.
Giữ defaultInputModes và defaultOutputModes phù hợp với những gì server của bạn thực sự chấp nhận và trả về.
Xác thực JSON cuối cùng và xuất bản nó tại /.well-known/agent-card.json trên tên miền dịch vụ của bạn.
Sẵn sàng xây dựng
Mở bất kỳ mẫu nào trong Trình tạo Agent Card, xem lại JSON, và xác thực nó trước khi xuất bản.