পাবলিক এজেন্ট আবিষ্কার
অন্য একটি A2A ক্লায়েন্ট আপনার এজেন্ট একটি কাজ সম্পন্ন করতে পারে কিনা তা নির্ধারণ করার আগে যে JSON আনে তা তৈরি করতে এই উদাহরণগুলি ব্যবহার করুন।
6টি কপি-প্রস্তুত JSON টেমপ্লেট · A2A v1.0
ব্যবহারিক A2A v1.0 টেমপ্লেট ব্রাউজ করুন, তাদের ডিজাইন সিদ্ধান্তগুলি বুঝুন, তারপর আপনার নিজের এজেন্টের জন্য যেকোনো উদাহরণ অভিযোজিত করুন।
অন্য একটি A2A ক্লায়েন্ট আপনার এজেন্ট একটি কাজ সম্পন্ন করতে পারে কিনা তা নির্ধারণ করার আগে যে JSON আনে তা তৈরি করতে এই উদাহরণগুলি ব্যবহার করুন।
প্রোভাইডার, স্কিল, ট্যাগ, ক্ষমতা, এবং নিরাপত্তা মেটাডেটা অভিযোজিত করুন যাতে পর্যালোচকরা বুঝতে পারেন এজেন্ট কী করে এবং কে এটি পরিচালনা করে।
দলগুলি ওয়ার্কফ্লোতে একীভূত করার আগে অভ্যন্তরীণ এজেন্ট জুড়ে এন্ডপয়েন্ট, প্রমাণীকরণ, এবং স্কিল বিবরণ মানসম্মত করুন।
JSON টেমপ্লেট
পণ্য প্রশ্ন, অর্ডার অনুসন্ধান, রিটার্ন, এবং এস্কেলেশন হ্যান্ডঅফ পরিচালনা করে।
কেন এভাবে তৈরি করা হয়েছে
{
"name": "গ্রাহক সহায়তা এজেন্ট",
"description": "গ্রাহক সহায়তার প্রশ্নের উত্তর দেয়, অর্ডারের প্রসঙ্গ পুনরুদ্ধার করে এবং অমীমাংসিত সমস্যাগুলি মানব দলের কাছে বাড়িয়ে দেয়।",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/customer-support",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "উদাহরণ 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": "গ্রাহক সমর্থন অনুরোধ সমাধান করুন",
"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": "উদাহরণ 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": "খুঁজুন এবং বুকিং প্রস্তুত",
"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": "উদাহরণ 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": "কেনাকাটার বিকল্পগুলি তুলনা করুন",
"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": "উদাহরণ 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": "কোড পরিবর্তন বাস্তবায়ন",
"description": "একটি কোডিং অনুরোধ পড়ে, প্রাসঙ্গিক ফাইলগুলি পরিদর্শন করে, একটি প্যাচ প্রস্তাব ফেরত দেয় এবং যাচাইকরণের পদক্ষেপগুলির সংক্ষিপ্ত বিবরণ দেয়৷",
"tags": [
"coding",
"review",
"patches"
],
"examples": [
"ব্যবহারকারীদের API এ পৃষ্ঠা সংখ্যা যোগ করুন।"
]
}
],
"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": "উদাহরণ 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": "গবেষণা সংক্ষিপ্ত প্রস্তুত",
"description": "অনুমোদিত উত্স অনুসন্ধান করে, দাবি এবং প্রমাণ বের করে এবং একটি সংক্ষিপ্ত গবেষণা সংক্ষিপ্ত বিবরণ প্রদান করে।",
"tags": [
"research",
"evidence",
"citations"
],
"examples": [
"নবায়নযোগ্য-শক্তি নীতির উপর একটি উদ্ধৃত সংক্ষিপ্ত বিবরণ প্রস্তুত করুন।"
]
}
]
}অনুমোদন, স্ট্যাটাস চেক, এবং ব্যাক-অফিস ওয়ার্কফ্লো আপডেট সমন্বয় করে।
কেন এভাবে তৈরি করা হয়েছে
{
"name": "অভ্যন্তরীণ ওয়ার্কফ্লো এজেন্ট",
"description": "অভ্যন্তরীণ অনুমোদন সমন্বয় করে, সিস্টেমের স্থিতি পরীক্ষা করে এবং অপারেশন টিমের জন্য ওয়ার্কফ্লো আপডেট প্রস্তুত করে।",
"supportedInterfaces": [
{
"url": "https://api.example.com/a2a/workflow",
"protocolBinding": "JSONRPC",
"protocolVersion": "1.0"
}
],
"provider": {
"organization": "উদাহরণ 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": "অভ্যন্তরীণ কর্মপ্রবাহ সমন্বয় করুন",
"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 Card গুলি সরল ভাষা এবং মেশিন-পাঠযোগ্য মেটাডেটা উভয়েই এজেন্টের কাজের সীমা ব্যাখ্যা করে। একজন ক্লায়েন্টের বলতে সক্ষম হওয়া উচিত এজেন্ট কী করতে পারে, কী করতে পারে না, কোন URL কল করতে হবে, এবং ক্রেডেনশিয়াল প্রয়োজন কিনা।
প্রতিটি example.com URL আপনার স্থাপিত A2A এন্ডপয়েন্ট এবং প্রোভাইডার ওয়েবসাইট দিয়ে প্রতিস্থাপন করুন।
প্রকৃত কাজের সীমার জন্য স্কিল নাম, বিবরণ, ট্যাগ (v1.0-এ প্রয়োজনীয়), এবং উদাহরণ পুনরায় লিখুন।
provider.organization সেট করুন এবং Agent Card বিষয়বস্তু পরিবর্তিত হলেই শীর্ষ-স্তরের version বাড়ান।
এন্ডপয়েন্ট ইচ্ছাকৃতভাবে পাবলিক হলেই কেবল প্রমাণীকরণ ফিল্ড সরান।
defaultInputModes এবং defaultOutputModes আপনার সার্ভার প্রকৃতপক্ষে যা গ্রহণ করে এবং ফেরত দেয় তার সাথে সামঞ্জস্যপূর্ণ রাখুন।
চূড়ান্ত JSON যাচাই করুন এবং আপনার সেবা ডোমেইনে /.well-known/agent-card.json-এ এটি প্রকাশ করুন।
তৈরি করতে প্রস্তুত
Agent Card জেনারেটরে যেকোনো প্যাটার্ন খুলুন, JSON পর্যালোচনা করুন, এবং প্রকাশ করার আগে এটি যাচাই করুন।