AgentCard.net APIمجاني خلال المرحلة التجريبية

أدوات Agent Card، مصممة للبرمجيات.

أنشئ بطاقات Agent Card وفق A2A v1.0 وتحقق منها وافحصها من تطبيقك أو مسار CI أو أداة المطور أو Agent مستقل.

ابدأ باستخدام cURLOpenAPI 3.1
HTTPS · JSON
POST/api/agent-card/validate
{
  "card": {
    "name": "Research Agent",
    "version": "1.0.0",
    "supportedInterfaces": [...]
  }
}
200 · validation.valid: true

01 · بدء سريع

أرسل طلبك الأول.

أرسل JSON عبر HTTPS. لا تحتاج خلال المرحلة التجريبية إلى حساب أو 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

إنشاء Agent Card

/api/agent-card/generate

تحويل تفاصيل الخدمة إلى JSON قابل للنشر وفق A2A v1.0 وإرجاع تقرير التحقق في الاستجابة نفسها.

عرض المثال
POST

التحقق من JSON لـ Agent Card

/api/agent-card/validate

فحص الهوية والواجهات والقدرات والأوضاع والمهارات وبيانات الأمان والحقول القديمة والأسرار المضمنة.

عرض المثال
POST

فحص الاكتشاف البعيد

/api/agent-card/check

فحص مساري well-known والتحقق من كل Agent Card يعيدها المضيف البعيد.

عرض المثال
POST/generate

إنشاء Agent Card

تحويل تفاصيل الخدمة إلى JSON قابل للنشر وفق A2A v1.0 وإرجاع تقرير التحقق في الاستجابة نفسها.

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

التحقق من JSON لـ Agent Card

فحص الهوية والواجهات والقدرات والأوضاع والمهارات وبيانات الأمان والحقول القديمة والأسرار المضمنة.

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 · الاستجابات

منظم لاتخاذ القرارات.

يفصل التحقق الأخطاء المانعة والتحذيرات المفيدة والفحوص الناجحة، ليتمكن البرنامج من القرار دون تحليل النص.

errorsيجعل valid بقيمة 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 كيلوبايت

يطبق على JSON الوارد وكل استجابة بعيدة.

مهلة 8 ثوانٍ

تتوقف الطلبات البعيدة سريعاً عند تعذر المضيف.

فحوص شبكة آمنة

ترفض العناوين الخاصة وعمليات إعادة التوجيه غير الآمنة.

لا حاجة إلى API Key في التجربة

الـ API مفتوحة حالياً مع تحديد تقريبي لكل IP.

تقبل الفحوص البعيدة مضيفات HTTP أو HTTPS العامة فقط.

تحظر نطاقات IP الخاصة والمحجوزة، ويفحص كل تحويل ويحدد حجم الاستجابة وتُعاد الأعطال لكل مسار.

06 · تحقيق الدخل

تجربة مجانية الآن ووصول حسب الاستخدام لاحقاً.

لا تتطلب API حالياً دفعاً أو API Key. يخطط AgentCard.net لاستخدام x402 عبر Cloudflare Monetization Gateway لعمليات مختارة مع إبقاء وثائق الاكتشاف عامة.

OpenAPI JSONجرّب أدوات الويب
مخطط Agent Cardأمثلة Agent Cardدليل URL لـ well-known