AgentCard.net APIใช้ฟรีในช่วงเบต้า

เครื่องมือ Agent Card ที่สร้างมาเพื่อซอฟต์แวร์

สร้าง ตรวจสอบ และสำรวจ A2A v1.0 Agent Card จากแอปพลิเคชัน CI pipeline เครื่องมือนักพัฒนา หรือ Agent อัตโนมัติ

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 · Endpoint

สามการทำงานที่ชัดเจน

ใช้ REST endpoint แยกในแอปทั่วไป หรือใช้ endpoint ทักษะแบบรวมเมื่อผู้เรียกเป็น Agent อื่น

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

ตรวจสอบ 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 สามารถตรวจสอบความสามารถก่อน แล้วเรียกทักษะผ่าน endpoint ที่เสถียร

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 สาธารณะ

จำกัด payload 256 KB

ใช้กับ JSON ขาเข้าและคำตอบระยะไกลทุกชุด

หมดเวลา 8 วินาที

หยุดคำขอระยะไกลอย่างรวดเร็วเมื่อโฮสต์ไม่พร้อม

ตรวจสอบเครือข่ายอย่างปลอดภัย

ปฏิเสธที่อยู่ส่วนตัวและ redirect ที่ไม่ปลอดภัย

ไม่ต้องใช้ API Key ในช่วงเบต้า

API เปิดใช้งานพร้อมจำกัดอัตราต่อ IP แบบ best-effort

การตรวจระยะไกลรับเฉพาะโฮสต์ HTTP หรือ HTTPS สาธารณะ

บล็อกช่วง IP ส่วนตัวและสงวน ตรวจทุก redirect จำกัดขนาดคำตอบ และคืนข้อผิดพลาดแยกตามเส้นทาง

06 · การสร้างรายได้

เบต้าฟรีตอนนี้ คิดตามการใช้งานภายหลัง

ขณะนี้ API ไม่ต้องชำระเงินหรือใช้ API Key AgentCard.net วางแผนใช้ x402 ผ่าน Cloudflare Monetization Gateway สำหรับงานที่เลือก พร้อมคงเอกสารการค้นหาไว้สาธารณะ