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 उपयोग करने की योजना बना रहा है।