আপনার এজেন্টকে আবিষ্কারযোগ্য করুন
একটি স্পষ্ট Agent Card A2A ক্লায়েন্টদের একটি নির্ভরযোগ্য সূচনা বিন্দু দেয়: এজেন্টটি কার, এটি কোথায় থাকে, এবং এটি কোন প্রোটোকল বাইন্ডিং ও সংস্করণ ব্যবহার করে।
Agent Card জেনারেটর আপনার AI এজেন্টের জন্য কী তৈরি করে
Agent Card হলো একটি A2A এজেন্টের পাবলিক ইন্টারফেস বিবরণ। অন্য একটি এজেন্ট আপনার সেবা কল করবে কিনা তা সিদ্ধান্ত নেওয়ার আগে, এর একটি URL-এর চেয়ে বেশি কিছু দরকার: এজেন্টের উদ্দেশ্য, প্রযুক্তিগত চুক্তি, স্কিল এবং অ্যাক্সেস প্রয়োজনীয়তার একটি নির্ভরযোগ্য বিবরণ প্রয়োজন।
এই Agent Card জেনারেটর সেই বাস্তবায়ন বিবরণগুলিকে পঠনযোগ্য, A2A v1.0-আকৃতির JSON-এ রূপান্তরিত করে, একইসাথে সিদ্ধান্ত গ্রহণকে ফর্মের কাছাকাছি রাখে। এজেন্টের মূল যুক্তি তৈরি করার পরে এবং এটি স্থাপন বা তালিকাভুক্ত করার আগে এটি ব্যবহার করুন — যেখানে হাতে লেখা JSON ফাইল সাধারণত ভেঙে যায়।
একটি ব্যবহারযোগ্য ইন্টারফেস বর্ণনা করুন
অন্য এজেন্টের কল করার আগে যে পছন্দের ইন্টারফেস, কনটেন্ট মোড, স্ট্রিমিং আচরণ, এবং পুশ নোটিফিকেশন সমর্থন প্রয়োজন তা ধারণ করুন।
অ্যাক্সেসের জন্য প্রত্যাশা নির্ধারণ করুন
নথিভুক্ত করুন যে সেবাটি পাবলিক কিনা, একটি API কী ব্যবহার করে, নাকি OAuth 2.0 প্রয়োজন, যাতে ইন্টিগ্রেশনগুলি সঠিক প্রমাণীকরণ প্রবাহ বেছে নিতে পারে — Agent Card কখনো কোনো ক্রেডেনশিয়াল না রেখে।
স্কিলকে স্পষ্ট চুক্তিতে রূপান্তর করুন
আপনার এজেন্ট যে কাজ করতে পারে তার নাম দিন, v1.0-এর প্রয়োজনীয় ট্যাগ এবং উপযোগী উদাহরণ যোগ করুন, এবং এর সীমানা মানুষ, মার্কেটপ্লেস এবং AI ক্লায়েন্টদের কাছে বোধগম্য করুন।
Agent Card জেনারেটর কীভাবে কাজ করে
সেবার বিবরণ থেকে প্রকাশযোগ্য Agent Card পর্যন্ত
Agent Card জেনারেটর সেবার বিবরণকে একটি স্পষ্ট, প্রকাশযোগ্য JSON নথিতে রূপান্তরিত করে। Agent Card প্রোডাকশনে পাঠানোর আগে এই সংক্ষিপ্ত ওয়ার্কফ্লো অনুসরণ করুন।
- 1
প্রকৃত সেবা দিয়ে শুরু করুন
পাবলিক A2A এন্ডপয়েন্ট, প্রোটোকল বাইন্ডিং, প্রোভাইডার বিবরণ, এজেন্ট সংস্করণ, এবং আপনার সার্ভার যে কনটেন্ট টাইপ গ্রহণ ও ফেরত দেয় তা যোগ করুন।
- 2
ক্ষমতা ও স্কিলের সীমা সংজ্ঞায়িত করুন
শুধুমাত্র আপনার বাস্তবায়ন সমর্থন করে এমন ক্ষমতা নির্বাচন করুন, তারপর একটি প্রতিনিধিত্বমূলক স্কিল সহজ, নির্দিষ্ট ভাষায় বর্ণনা করুন।
- 3
তৈরি করা JSON পর্যালোচনা করুন
অনুপস্থিত ফিল্ড, প্লেসহোল্ডার URL, বা বিবরণ যা স্থাপন করা সেবাকে সঠিকভাবে প্রতিফলিত করে না তা খুঁজে পেতে লাইভ প্রিভিউ ব্যবহার করুন।
- 4
যাচাই করুন এবং প্রকাশ করুন
Agent Card ভ্যালিডেটরের মধ্য দিয়ে চালান, তারপর পর্যালোচিত নথিটি আপনার সেবা ডোমেইনে /.well-known/agent-card.json-এ স্থাপন করুন।
কারা Agent Card জেনারেটর ব্যবহার করে
যারা Agent Card তৈরি, প্রকাশ বা পর্যালোচনা করেন তাদের সবার জন্য তৈরি
Agent Card জেনারেটর নির্মাতা, প্ল্যাটফর্ম দল এবং পর্যালোচকদের একটি খালি JSON ফাইল থেকে শুরু না করে সামঞ্জস্যপূর্ণ A2A এজেন্ট মেটাডেটা তৈরি করতে সহায়তা করে।
AI এবং স্বতন্ত্র ডেভেলপাররা
A2A-সামঞ্জস্যপূর্ণ এজেন্ট চালু করার সময় হাতে লেখা agent-card.json-কে একটি সম্পূর্ণ, স্পেক-আকৃতির সূচনা বিন্দু দিয়ে প্রতিস্থাপন করুন।
প্রম্পট ইঞ্জিনিয়ার এবং প্রোডাক্ট ম্যানেজাররা
JSON সিনট্যাক্স স্পর্শ না করে সেবার বিবরণ থেকে একটি বিশ্বাসযোগ্য আবিষ্কার নথি তৈরি করুন, তারপর পর্যালোচনার জন্য প্রকৌশল দলে হস্তান্তর করুন।
প্ল্যাটফর্ম এবং DevOps দল
কোম্পানির এজেন্ট ক্যাটালগ বা CI পাইপলাইনে প্রবেশের আগে অভ্যন্তরীণ এজেন্টরা কীভাবে এন্ডপয়েন্ট, প্রমাণীকরণ এবং স্কিল বর্ণনা করে তা মানসম্মত করুন।
মার্কেটপ্লেস প্রকাশকরা
প্রোভাইডার মেটাডেটা, স্কিল ট্যাগ, এবং নিরাপত্তা ঘোষণা প্রস্তুত করুন যা পর্যালোচক এবং র্যাঙ্কিং সিস্টেম প্রকৃতপক্ষে পার্স করতে পারে।
সাধারণ প্রশ্ন
Agent Card জেনারেটর সম্পর্কে সাধারণ প্রশ্ন
একটি A2A ক্লায়েন্ট আপনার এন্ডপয়েন্ট খুঁজে পাওয়ার আগে মূল বিষয়গুলি ঠিক করুন।
A2A Agent Card কী?
A2A Agent Card হলো একটি AI এজেন্টের জন্য একটি JSON আবিষ্কার নথি। এটি সম্ভাব্য ক্লায়েন্টদের কাছে পরিচয়, প্রোভাইডার তথ্য, সমর্থিত ইন্টারফেস, ক্ষমতা, স্কিল, গ্রহণযোগ্য কনটেন্ট মোড, এবং নিরাপত্তা প্রয়োজনীয়তা জানায় — README এবং API সংক্ষিপ্ত বিবরণের এজেন্ট-টু-এজেন্ট সমতুল্য।
হাতে JSON লেখার পরিবর্তে কেন Agent Card জেনারেটর ব্যবহার করবেন?
হাতে লেখা Agent Card নিয়মিতভাবে প্রয়োজনীয় ফিল্ড অনুপস্থিত, v1.0-পূর্ববর্তী ফিল্ড নাম, বা সিনট্যাক্স ত্রুটিসহ পাঠানো হয়। জেনারেটর বর্তমান A2A v1.0 আকৃতি — supportedInterfaces, provider.organization, প্রয়োজনীয় স্কিল ট্যাগ — তৈরি করে এবং আপনি টাইপ করার সময় যাচাই করে, তাই কাঠামোগত ভুল কখনো প্রোডাকশনে পৌঁছায় না।
তৈরি করা Agent Card কোন A2A সংস্করণকে লক্ষ্য করে?
জেনারেটর A2A v1.0 কাঠামো তৈরি করে: প্রতি-ইন্টারফেস protocolBinding এবং protocolVersion সহ একটি ক্রমযুক্ত supportedInterfaces অ্যারে, একটি শীর্ষ-স্তরের এজেন্ট version, এবং extendedAgentCard সহ ক্ষমতা। শীর্ষ-স্তরের url বা preferredTransport ফিল্ডযুক্ত Agent Card v1.0-পূর্ববর্তী।
প্রোডাকশনের আগে তৈরি করা JSON কি পর্যালোচনার প্রয়োজন?
হ্যাঁ। জেনারেটর একটি ব্যবহারিক সূচনা নথি তৈরি করে, আপনার স্থাপিত চুক্তির বিকল্প নয়। নিশ্চিত করুন যে এন্ডপয়েন্ট, প্রোটোকল বাইন্ডিং, স্কিল, এবং প্রমাণীকরণ ব্যবহারকারীরা প্রকৃতপক্ষে যে সেবায় পৌঁছাবে তার সাথে মিলে যায়।
আমি কোথায় একটি Agent Card প্রকাশ করব?
পর্যালোচিত JSON আপনার A2A সেবার একই ডোমেইনে https://your-domain/.well-known/agent-card.json-এ প্রকাশ করুন, যা A2A স্পেসিফিকেশন দ্বারা নিবন্ধিত well-known পথ। অনেক পুরনো ইন্টিগ্রেশন /.well-known/agent.json-ও পরীক্ষা করে, তাই উভয়ই পরিবেশন করা একটি নিরাপদ রূপান্তর কৌশল।
প্রকাশের জন্য প্রস্তুত
প্রকাশ করার আগে Agent Card জেনারেটরে ফিরে যান।
বিবরণ সম্পূর্ণ করুন, তৈরি করা JSON পর্যালোচনা করুন, এবং আপনার Agent Card প্রকাশ করার আগে লাইভ যাচাই ব্যবহার করুন।