AgentCard.net APIবেটা চলাকালে বিনামূল্যে

Agent Card টুলিং, সফটওয়্যারের জন্য তৈরি।

আপনার অ্যাপ, CI পাইপলাইন, ডেভেলপার টুল বা স্বয়ংক্রিয় Agent থেকে A2A v1.0 Agent Card তৈরি, যাচাই ও পরীক্ষা করুন।

HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · দ্রুত শুরু

আপনার প্রথম অনুরোধ পাঠান।

HTTPS দিয়ে JSON পাঠান। বেটা চলাকালে অ্যাকাউন্ট বা API Key দরকার নেই। এই উদাহরণ এক কলেই সম্পূর্ণ Agent Card তৈরি ও যাচাই করে।

Base URLhttps://www.agentcard.net
cURL · generate
curl -X POST https://www.agentcard.net/api/agent-card/generate \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Agent",
    "description": "Finds and summarizes public research for developer questions.",
    "endpointUrl": "https://api.example.com/a2a/research",
    "skillName": "Research a topic",
    "skillDescription": "Finds relevant sources and returns a cited summary.",
    "skillTags": ["research", "search"]
  }'

02 · এন্ডপয়েন্ট

তিনটি নির্দিষ্ট অপারেশন।

সাধারণ অ্যাপে আলাদা REST এন্ডপয়েন্ট, আর অন্য Agent কল করলে একীভূত স্কিল এন্ডপয়েন্ট ব্যবহার করুন।

POST/generate

Agent Card তৈরি করুন

সেবার তথ্যকে প্রকাশযোগ্য A2A v1.0 JSON-এ রূপান্তর করে এবং একই রেসপন্সে যাচাই রিপোর্ট দেয়।

cURL · generate
curl -X POST https://www.agentcard.net/api/agent-card/generate \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Research Agent",
    "description": "Finds and summarizes public research for developer questions.",
    "endpointUrl": "https://api.example.com/a2a/research",
    "skillName": "Research a topic",
    "skillDescription": "Finds relevant sources and returns a cited summary.",
    "skillTags": ["research", "search"]
  }'
POST/validate

Agent Card JSON যাচাই করুন

পরিচয়, ইন্টারফেস, সক্ষমতা, মোড, স্কিল, নিরাপত্তা মেটাডেটা, পুরোনো ফিল্ড ও এমবেড করা সিক্রেট পরীক্ষা করে।

cURL · validate
curl -X POST https://www.agentcard.net/api/agent-card/validate \
  -H "Content-Type: application/json" \
  -d '{
    "card": {
      "name": "Research Agent",
      "description": "Finds and summarizes public research.",
      "version": "1.0.0",
      "supportedInterfaces": [{
        "url": "https://api.example.com/a2a/research",
        "protocolBinding": "HTTP+JSON",
        "protocolVersion": "1.0"
      }],
      "capabilities": {},
      "defaultInputModes": ["text/plain"],
      "defaultOutputModes": ["application/json"],
      "skills": [{
        "id": "research",
        "name": "Research",
        "description": "Finds relevant sources and returns a cited summary.",
        "tags": ["research"]
      }]
    }
  }'
POST/check

রিমোট ডিসকভারি পরীক্ষা করুন

দুটি well-known পথ পরীক্ষা করে এবং রিমোট হোস্টের প্রতিটি Agent Card যাচাই করে।

cURL · remote check
curl -X POST https://www.agentcard.net/api/agent-card/check \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

03 · Agent ইন্টিগ্রেশন

Agent-কে API খুঁজে কল করতে দিন।

AgentCard.net পরিপূরক ডিসকভারি ফরম্যাট প্রকাশ করে। Agent আগে সক্ষমতা দেখে একটি স্থিতিশীল এন্ডপয়েন্ট দিয়ে স্কিল চালাতে পারে।

POST /api/agent-card
{
  "skillId": "validate-agent-card",
  "input": {
    "card": {
      "name": "Example Agent",
      "description": "..."
    }
  }
}

04 · রেসপন্স

সিদ্ধান্তের জন্য কাঠামোবদ্ধ।

যাচাই ফল ব্লকিং ত্রুটি, দরকারি সতর্কতা ও সফল পরীক্ষা আলাদা করে, তাই সফটওয়্যার গদ্য বিশ্লেষণ ছাড়াই সিদ্ধান্ত নিতে পারে।

errorsvalid-কে false করে

warningsপ্রস্তুতির ঘাটতি দেখায়

passesসফল পরীক্ষা নিশ্চিত করে

JSON response
{
  "validation": {
    "valid": false,
    "errors": [
      {
        "severity": "error",
        "message": "Missing required field: version."
      }
    ],
    "warnings": [],
    "passes": [
      {
        "severity": "pass",
        "message": "Agent name is present."
      }
    ]
  }
}

05 · সীমা

পাবলিক API-এর নিরাপদ ডিফল্ট।

256 KB পেলোড সীমা

ইনকামিং JSON ও প্রতিটি রিমোট রেসপন্সে প্রযোজ্য।

8 সেকেন্ড টাইমআউট

হোস্ট না পাওয়া গেলে রিমোট অনুরোধ দ্রুত থামে।

নিরাপদ নেটওয়ার্ক পরীক্ষা

প্রাইভেট ঠিকানা ও অনিরাপদ রিডাইরেক্ট প্রত্যাখ্যান করা হয়।

বেটায় API Key নেই

API এখন প্রতি IP best-effort সীমাসহ উন্মুক্ত।

রিমোট পরীক্ষা শুধু পাবলিক HTTP বা HTTPS হোস্ট গ্রহণ করে।

প্রাইভেট ও সংরক্ষিত IP রেঞ্জ ব্লক হয়; প্রতিটি রিডাইরেক্ট পরীক্ষা, রেসপন্স সীমিত এবং প্রতিটি পথের ত্রুটি আলাদাভাবে ফেরত আসে।

06 · মনিটাইজেশন

এখন বিনামূল্যের বেটা, পরে ব্যবহারভিত্তিক অ্যাক্সেস।

এখন পেমেন্ট বা API Key লাগে না। AgentCard.net ডিসকভারি ডকুমেন্ট উন্মুক্ত রেখে নির্বাচিত ভারী অপারেশনে Cloudflare Monetization Gateway-এর মাধ্যমে x402 ব্যবহারের পরিকল্পনা করছে।