Agent Card ভ্যালিডেটর পেস্ট করা JSON, আপলোড করা Agent Card ফাইল, এবং পাবলিক এজেন্ট URL A2A v1.0 আবিষ্কার প্রয়োজনীয়তার বিরুদ্ধে পরীক্ষা করে।
JSON, একটি পাবলিক এজেন্ট URL পেস্ট করুন, অথবা সম্পাদকে একটি JSON ফাইল টেনে আনুন।
Agent Card ভ্যালিডেটর কভারেজ
Agent Card ভ্যালিডেটর A2A এজেন্ট প্রকাশকারী ডেভেলপার, এজেন্ট মেটাডেটা পর্যালোচনাকারী অভ্যন্তরীণ প্ল্যাটফর্ম দল, এবং জমা দেওয়া Agent Card নির্ভরযোগ্য আহ্বানের জন্য পর্যাপ্ত তথ্য আছে কিনা তা পরীক্ষাকারী মার্কেটপ্লেস অপারেটরদের জন্য ডিজাইন করা হয়েছে।
উন্নয়নের সময় একটি স্থানীয় JSON নথি পেস্ট করুন, আপনার রিপোজিটরি থেকে একটি Agent Card আপলোড করুন, বা পাবলিক আবিষ্কার পথ যাচাই করতে স্থাপন করা ডোমেইনের বিরুদ্ধে লাইভ URL যাচাই ব্যবহার করুন।
v1.0 স্পেসিফিকেশনের বিরুদ্ধে প্রয়োজনীয় ফিল্ড পরীক্ষা করে: name, description, version, প্রতি-ইন্টারফেস protocolBinding এবং protocolVersion সহ supportedInterfaces, capabilities, কনটেন্ট মোড, এবং প্রয়োজনীয় ট্যাগসহ কমপক্ষে একটি স্কিল।
v1.0-পূর্ববর্তী কাঠামো সনাক্ত করে — শীর্ষ-স্তরের url, preferredTransport, protocolVersion, provider.name, stateTransitionHistory — এবং আপনাকে সঠিকভাবে বলে যে প্রতিটি ফিল্ড v1.0-এ ঠিক কোথায় স্থানান্তরিত হয়েছে।
যাচাই করে যে নন-পাবলিক এন্ডপয়েন্টের জন্য securitySchemes এবং নিরাপত্তা প্রয়োজনীয়তা ঘোষিত আছে, নন-HTTPS URL চিহ্নিত করে, এবং এমবেডেড API কী, JWT, বা bearer টোকেনের মতো দেখতে মান স্ক্যান করে।
একটি লাইভ ডোমেইন থেকে /.well-known/agent-card.json এবং লেগেসি /.well-known/agent.json আনে এবং নিশ্চিত করে যে উভয়ই পার্স-যোগ্য Agent Card JSON ফেরত দেয়।
যাচাই কোথায় খাপ খায়
গত মাসে পর্যালোচনায় পাস করা একটি Agent Card আজও আবিষ্কার ভাঙতে পারে — একটি এন্ডপয়েন্ট সরে যায়, একটি স্কিল পরিবর্তিত হয়, একটি পুনঃস্থাপন well-known রুট বাদ দেয়। প্ল্যাটফর্ম দল এবং মার্কেটপ্লেস পর্যালোচকরা যাচাইকে একবারের পরীক্ষা নয়, একটি পুনরাবৃত্তিযোগ্য গেট হিসাবে বিবেচনা করে।
সবচেয়ে সহজ CI সুরক্ষার জন্য curl ছাড়া আর কিছু দরকার নেই: ট্রাফিক নতুন স্থাপনায় স্যুইচ করার আগে নিশ্চিত করুন যে well-known পথ পার্স-যোগ্য JSON দিয়ে সাড়া দেয়।
# deploy pipeline: fail if the published card breaks
curl -fsS https://your-domain/.well-known/agent-card.json \
| python3 -c '
import json, sys
card = json.load(sys.stdin)
assert card.get("name"), "name is required"
assert card.get("supportedInterfaces"), "supportedInterfaces missing"
assert card.get("skills"), "skills missing"
print("agent card OK:", card["name"])'সমাধান গাইড
প্রথমে প্রয়োজনীয় ফিল্ডগুলি সমাধান করতে Agent Card ভ্যালিডেটর রিপোর্ট ব্যবহার করুন, তারপর আবিষ্কার, বিশ্বাস, এবং মাইগ্রেশন বিবরণ উন্নত করুন।
প্লেসহোল্ডার এন্ডপয়েন্ট URL গুলি স্থাপন করা HTTPS A2A সেবা URL দিয়ে প্রতিস্থাপন করুন।
শীর্ষ-স্তরের url এবং preferredTransport একটি ক্রমযুক্ত supportedInterfaces অ্যারেতে সরান — প্রথম এন্ট্রিটি পছন্দের ইন্টারফেস।
এজেন্ট নিজেকে বর্ণনা করে এমন প্রয়োজনীয় শীর্ষ-স্তরের version ফিল্ড যোগ করুন, এবং প্রতিটি স্কিলে ট্যাগ যোগ করুন।
provider.name-এর নাম পরিবর্তন করে provider.organization করুন এবং সংক্ষিপ্ত বিবরণ প্রসারিত করুন যাতে ক্লায়েন্টরা জানে কখন এজেন্টকে আহ্বান করতে হবে।
যখনই এজেন্ট এন্ডপয়েন্ট সম্পূর্ণভাবে পাবলিক না হয় তখন নিরাপত্তা মেটাডেটা ঘোষণা করুন — এবং ক্রেডেনশিয়াল নিজেই কখনো এমবেড করবেন না।
একই বৈধ Agent Card /.well-known/agent-card.json-এ প্রকাশ করুন (এবং ক্লায়েন্টরা এখনও উভয়ই পরীক্ষা করার সময় লেগেসি agent.json পথেও)।
সাধারণ প্রশ্ন
আপনার এজেন্ট একটি A2A ক্লায়েন্টে পৌঁছানোর আগে মূল বিষয়গুলি ঠিক করুন।
বৈধ উদাহরণ তুলনা করুনপরীক্ষাগুলি A2A v1.0 Agent Card কাঠামো অনুসরণ করে — supportedInterfaces, প্রতি-ইন্টারফেস প্রোটোকল সংস্করণ, প্রয়োজনীয় স্কিল ট্যাগ, provider.organization। v1.0-পূর্ববর্তী Agent Card সরাসরি প্রত্যাখ্যাত হয় না: লেগেসি ফিল্ডগুলি সঠিক v1.0 প্রতিস্থাপনসহ সতর্কতা হিসাবে প্রদর্শিত হয়।
v1.0 স্পেসিফিকেশন /.well-known/agent-card.json নিবন্ধিত করে, কিন্তু পূর্ববর্তী A2A বাস্তবায়ন /.well-known/agent.json ব্যবহার করত। উভয়ই পরীক্ষা করা ক্লায়েন্ট ব্যর্থ হওয়ার আগে আবিষ্কার ফাঁক ধরে।
সতর্কতা JSON ত্রুটির মতো ব্লক করে না, তবে সাধারণত মেটাডেটার দিকে নির্দেশ করে যা এজেন্টকে আবিষ্কার, বিশ্বাস, এবং কল করা সহজ করে তোলে — অথবা v1.0-পূর্ববর্তী ফিল্ডের দিকে যা নতুন ক্লায়েন্টরা পড়া বন্ধ করে দেবে।
তিনটি মুহূর্ত: উন্নয়নের সময় একটি Agent Card সম্পাদনা করার সময়, স্থাপনার আগে একটি CI গেট হিসাবে, এবং প্রকাশের পরে — উভয় আবিষ্কার পথ থেকে ক্লায়েন্টরা প্রকৃতপক্ষে কী পায় তা নিশ্চিত করতে লাইভ সেবা URL পেস্ট করুন।
যাচাই করতে প্রস্তুত
একীভূত ভ্যালিডেটর ওয়ার্কস্পেস থেকে JSON পেস্ট করুন, একটি Agent Card ফাইল ফেলুন, বা একটি পাবলিক URL পরীক্ষা করুন।