सार्वजनिक एजेंट खोज
इन उदाहरणों का उपयोग उस JSON को आकार देने के लिए करें जिसे कोई अन्य A2A क्लाइंट यह तय करने से पहले लाता है कि आपका एजेंट कोई कार्य पूरा कर सकता है या नहीं।
6 कॉपी-रेडी JSON टेम्पलेट · A2A v1.0
व्यावहारिक A2A v1.0 टेम्पलेट ब्राउज़ करें, उनके डिज़ाइन निर्णयों को समझें, फिर अपने खुद के एजेंट के लिए किसी भी उदाहरण को अनुकूलित करें।
इन उदाहरणों का उपयोग उस JSON को आकार देने के लिए करें जिसे कोई अन्य A2A क्लाइंट यह तय करने से पहले लाता है कि आपका एजेंट कोई कार्य पूरा कर सकता है या नहीं।
प्रोवाइडर, स्किल्स, टैग, क्षमताओं, और सुरक्षा मेटाडेटा को अनुकूलित करें ताकि समीक्षक समझ सकें कि एजेंट क्या करता है और इसे कौन संचालित करता है।
टीमों द्वारा उन्हें वर्कफ़्लो में एकीकृत करने से पहले आंतरिक एजेंटों में एंडपॉइंट, प्रमाणीकरण, और स्किल विवरणों को मानकीकृत करें।
JSON टेम्पलेट
उत्पाद प्रश्नों, ऑर्डर लुकअप, रिटर्न, और एस्केलेशन हैंडऑफ़ को संभालता है।
इसे इस तरह क्यों बनाया गया है
{
"name": "ग्राहक सहायता एजेंट",
"description": "ग्राहक सहायता प्रश्नों का उत्तर देता है, ऑर्डर संदर्भ पुनः प्राप्त करता है, और अनसुलझे मुद्दों को एक मानव टीम तक पहुंचाता है।",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/customer-support",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "उदाहरण इंक.",
"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": "ग्राहक सहायता अनुरोध का समाधान करें",
"description": "ग्राहक सहायता अनुरोध को वर्गीकृत करता है, आवश्यक संदर्भ एकत्र करता है, एक समाधान प्रस्तावित करता है, और आत्मविश्वास कम होने पर आगे बढ़ता है।",
"tags": [
"support",
"orders",
"returns"
],
"examples": [
"मेरा ऑर्डर वापस करने में मेरी मदद करें."
]
}
],
"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"
]
}
]
}उपलब्ध अपॉइंटमेंट स्लॉट खोजता है और बुकिंग पुष्टिकरण तैयार करता है।
इसे इस तरह क्यों बनाया गया है
{
"name": "बुकिंग एजेंट",
"description": "उपलब्धता खोजता है, बुकिंग विकल्प प्रस्तावित करता है, और अनुमोदन के लिए नियुक्ति आरक्षण तैयार करता है।",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/booking",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "उदाहरण इंक.",
"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": "बुकिंग ढूंढें और तैयार करें",
"description": "संसाधन उपलब्धता की जाँच करता है, बुकिंग विंडो की तुलना करता है, और एक संरचित आरक्षण प्रस्ताव लौटाता है।",
"tags": [
"booking",
"calendar",
"availability"
],
"examples": [
"कल दोपहर 30 मिनट का अपॉइंटमेंट ढूंढें।"
]
}
],
"securitySchemes": {
"apiKey": {
"apiKeySecurityScheme": {
"location": "header",
"name": "X-API-Key"
}
}
},
"security": [
{
"apiKey": []
}
]
}उत्पादों, उपलब्धता, कीमतों, और खरीद बाधाओं की तुलना करता है।
इसे इस तरह क्यों बनाया गया है
{
"name": "शॉपिंग एजेंट",
"description": "उपयोगकर्ता की बाधाओं के विरुद्ध उत्पादों की तुलना करता है और ट्रेडऑफ़ के साथ क्रमबद्ध खरीद विकल्प लौटाता है।",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/shopping",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "उदाहरण इंक.",
"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": "खरीदारी के विकल्पों की तुलना करें",
"description": "उम्मीदवार उत्पादों का मूल्यांकन करता है, बाधाओं के आधार पर फ़िल्टर करता है, और तर्क के साथ रैंक की गई अनुशंसाएँ लौटाता है।",
"tags": [
"shopping",
"commerce",
"recommendations"
],
"examples": [
"1,200 डॉलर से कम कीमत वाले हल्के लैपटॉप की तुलना करें।"
]
}
],
"securitySchemes": {
"oauth2": {
"oauth2SecurityScheme": {
"flows": {
"clientCredentials": {
"tokenUrl": "https://api.example.com/a2a/shopping/oauth/token",
"scopes": {
"agent.invoke": "Invoke agent skills"
}
}
}
}
}
},
"security": [
{
"oauth2": [
"agent.invoke"
]
}
]
}कोड कार्यों की समीक्षा करता है, पैच प्रस्तावित करता है, और कार्यान्वयन निर्णयों की व्याख्या करता है।
इसे इस तरह क्यों बनाया गया है
{
"name": "कोडिंग एजेंट",
"description": "कोड का विश्लेषण करके, परिवर्तनों का प्रस्ताव देकर और कार्यान्वयन नोट्स लौटाकर सॉफ़्टवेयर इंजीनियरिंग कार्यों में सहायता करता है।",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/coding",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "उदाहरण इंक.",
"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": "कोड परिवर्तन लागू करें",
"description": "कोडिंग अनुरोध पढ़ता है, प्रासंगिक फ़ाइलों का निरीक्षण करता है, पैच प्रस्ताव लौटाता है, और सत्यापन चरणों का सारांश देता है।",
"tags": [
"coding",
"review",
"patches"
],
"examples": [
"उपयोगकर्ता एपीआई में पेजिनेशन जोड़ें।"
]
}
],
"securitySchemes": {
"apiKey": {
"apiKeySecurityScheme": {
"location": "header",
"name": "X-API-Key"
}
}
},
"security": [
{
"apiKey": []
}
]
}स्रोत एकत्र करता है, साक्ष्य निकालता है, और संरचित रिसर्च नोट्स लौटाता है।
इसे इस तरह क्यों बनाया गया है
{
"name": "रिसर्च एजेंट",
"description": "स्रोत सामग्री एकत्र करता है, साक्ष्य निकालता है, और उद्धरणों के साथ संरचित शोध नोट्स तैयार करता है।",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/research",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "उदाहरण इंक.",
"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": "शोध संक्षिप्त तैयार करें",
"description": "स्वीकृत स्रोतों की खोज करता है, दावे और सबूत निकालता है, और एक संक्षिप्त शोध विवरण देता है।",
"tags": [
"research",
"evidence",
"citations"
],
"examples": [
"नवीकरणीय-ऊर्जा नीति पर एक उद्धृत संक्षिप्त विवरण तैयार करें।"
]
}
]
}अनुमोदन, स्थिति जाँच, और बैक-ऑफ़िस वर्कफ़्लो अपडेट का समन्वय करता है।
इसे इस तरह क्यों बनाया गया है
{
"name": "आंतरिक वर्कफ़्लो एजेंट",
"description": "आंतरिक अनुमोदनों का समन्वय करता है, सिस्टम स्थिति की जाँच करता है, और संचालन टीमों के लिए वर्कफ़्लो अपडेट तैयार करता है।",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/workflow",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "उदाहरण इंक.",
"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": "आंतरिक कार्यप्रवाह का समन्वय करें",
"description": "वर्कफ़्लो आशय प्राप्त करता है, नीति आवश्यकताओं की जाँच करता है, अनुमोदन एकत्र करता है, और अंतिम स्थिति की रिपोर्ट करता है।",
"tags": [
"workflow",
"operations",
"approval"
],
"examples": [
"पेरोल अद्यतन को तैनात करने के लिए अनुमोदन का अनुरोध करें।"
]
}
],
"securitySchemes": {
"oauth2": {
"oauth2SecurityScheme": {
"flows": {
"clientCredentials": {
"tokenUrl": "https://api.example.com/a2a/workflow/oauth/token",
"scopes": {
"agent.invoke": "Invoke agent skills"
}
}
}
}
}
},
"security": [
{
"oauth2": [
"agent.invoke"
]
}
]
}आत्मविश्वास के साथ अनुकूलित करें
प्रत्येक Agent Card उदाहरण जानबूझकर कॉपी करने के लिए पर्याप्त रूप से पूर्ण है, लेकिन Agent Card को बिना बदलाव के प्रकाशित नहीं किया जाना चाहिए। इसे अपने खुद के A2A सर्वर के लिए एक फ़ील्ड मैप के रूप में मानें: पहचान, एंडपॉइंट, प्रोवाइडर, प्रमाणीकरण, क्षमताओं, मोड, और स्किल विवरणों को उत्पादन मूल्यों से बदलें।
सबसे मजबूत Agent Cards सरल भाषा और मशीन-पठनीय मेटाडेटा दोनों में एजेंट कार्य सीमा की व्याख्या करते हैं। एक क्लाइंट को यह बताने में सक्षम होना चाहिए कि एजेंट क्या कर सकता है, क्या नहीं कर सकता, किस URL को कॉल करना है, और क्या क्रेडेंशियल आवश्यक हैं।
हर example.com URL को अपने तैनात A2A एंडपॉइंट और प्रोवाइडर वेबसाइट से बदलें।
वास्तविक कार्य सीमा के लिए स्किल नाम, विवरण, टैग (v1.0 में आवश्यक), और उदाहरण फिर से लिखें।
provider.organization सेट करें और जब भी Agent Card सामग्री बदले शीर्ष-स्तरीय version बढ़ाएं।
प्रमाणीकरण फ़ील्ड को केवल तभी हटाएं जब एंडपॉइंट जानबूझकर सार्वजनिक हो।
defaultInputModes और defaultOutputModes को उसके साथ संरेखित रखें जो आपका सर्वर वास्तव में स्वीकार करता और लौटाता है।
अंतिम JSON को सत्यापित करें और इसे अपने सेवा डोमेन पर /.well-known/agent-card.json पर प्रकाशित करें।
निर्माण के लिए तैयार
Agent Card जनरेटर में कोई भी पैटर्न खोलें, JSON की समीक्षा करें, और प्रकाशित करने से पहले इसे सत्यापित करें।