เครื่องมือสร้าง Agent Card สร้างอะไรให้กับเอเจนต์ AI ของคุณ

Agent Card คือคำอธิบายอินเทอร์เฟซสาธารณะของเอเจนต์ A2A ก่อนที่เอเจนต์อื่นจะตัดสินใจเรียกใช้บริการของคุณได้ มันต้องการมากกว่า URL: ต้องการคำอธิบายที่เชื่อถือได้เกี่ยวกับวัตถุประสงค์ สัญญาทางเทคนิค สกิล และข้อกำหนดการเข้าถึงของเอเจนต์

เครื่องมือสร้าง Agent Card นี้แปลงรายละเอียดการใช้งานเหล่านั้นเป็น JSON ที่อ่านง่ายในรูปแบบ A2A v1.0 พร้อมทั้งเก็บการตัดสินใจให้ใกล้ชิดกับฟอร์ม ใช้เครื่องมือนี้หลังจากที่คุณสร้างตรรกะหลักของเอเจนต์เสร็จแล้ว และก่อนที่จะนำไปใช้งานหรือลงรายการ — จุดที่ไฟล์ JSON ที่เขียนด้วยมือมักจะพัง

ทำให้เอเจนต์ของคุณถูกค้นพบได้

Agent Card ที่ชัดเจนให้จุดเริ่มต้นที่เชื่อถือได้แก่ไคลเอนต์ A2A: เอเจนต์เป็นของใคร อยู่ที่ไหน และรองรับการเชื่อมโยงโปรโตคอลและเวอร์ชันใดบ้าง

อธิบายอินเทอร์เฟซที่ใช้งานได้

บันทึกอินเทอร์เฟซที่ต้องการ โหมดเนื้อหา พฤติกรรมการสตรีม และการรองรับการแจ้งเตือนแบบพุชที่เอเจนต์อื่นต้องการก่อนทำการเรียก

กำหนดความคาดหวังสำหรับการเข้าถึง

บันทึกว่าบริการเป็นสาธารณะ ใช้คีย์ API หรือต้องการ OAuth 2.0 เพื่อให้การผสานรวมสามารถเลือกขั้นตอนการยืนยันตัวตนที่ถูกต้องได้ — โดยไม่ใส่ข้อมูลรับรองใด ๆ ไว้ใน Agent Card

เปลี่ยนสกิลให้เป็นสัญญาที่ชัดเจน

ตั้งชื่องานที่เอเจนต์ของคุณสามารถทำได้ เพิ่มแท็กที่ v1.0 กำหนดพร้อมตัวอย่างที่เป็นประโยชน์ และทำให้ขอบเขตของมันเข้าใจได้สำหรับผู้คน มาร์เก็ตเพลส และไคลเอนต์ AI

เครื่องมือสร้าง Agent Card ทำงานอย่างไร

จากรายละเอียดบริการสู่ Agent Card ที่พร้อมเผยแพร่

เครื่องมือสร้าง Agent Card แปลงรายละเอียดบริการเป็นเอกสาร JSON ที่ชัดเจนและพร้อมเผยแพร่ ทำตามขั้นตอนการทำงานสั้น ๆ นี้ก่อนส่ง Agent Card ไปยังการใช้งานจริง

  1. 1

    เริ่มต้นด้วยบริการจริง

    เพิ่มเอนด์พอยต์ A2A สาธารณะ การเชื่อมโยงโปรโตคอล รายละเอียดผู้ให้บริการ เวอร์ชันเอเจนต์ และประเภทเนื้อหาที่เซิร์ฟเวอร์ของคุณยอมรับและส่งกลับ

  2. 2

    กำหนดขอบเขตความสามารถและสกิล

    เลือกเฉพาะความสามารถที่การใช้งานของคุณรองรับ จากนั้นอธิบายสกิลตัวแทนหนึ่งอย่างด้วยภาษาที่เรียบง่ายและเจาะจง

  3. 3

    ตรวจสอบ JSON ที่สร้างขึ้น

    ใช้ตัวอย่างสดเพื่อค้นหาฟิลด์ที่ขาดหายไป URL ตัวยึดตำแหน่ง หรือคำอธิบายที่ไม่สะท้อนบริการที่ปรับใช้อย่างถูกต้อง

  4. 4

    ตรวจสอบและเผยแพร่

    ให้ Agent Card ผ่านตัวตรวจสอบ จากนั้นวางเอกสารที่ตรวจทานแล้วไว้ที่ /.well-known/agent-card.json บนโดเมนบริการของคุณ

ใครใช้เครื่องมือสร้าง Agent Card

สร้างขึ้นสำหรับทุกคนที่สร้าง เผยแพร่ หรือตรวจสอบ Agent Card

เครื่องมือสร้าง Agent Card ช่วยผู้สร้าง ทีมแพลตฟอร์ม และผู้ตรวจสอบสร้างข้อมูลเมตาของเอเจนต์ A2A ที่สอดคล้องกันโดยไม่ต้องเริ่มจากไฟล์ JSON ที่ว่างเปล่า

เริ่มจากตัวอย่างแทน

นักพัฒนา AI และนักพัฒนาอิสระ

แทนที่ agent-card.json ที่เขียนด้วยมือด้วยจุดเริ่มต้นที่สมบูรณ์และตรงตามข้อกำหนดเมื่อเปิดตัวเอเจนต์ที่เข้ากันได้กับ A2A

วิศวกรพรอมต์และผู้จัดการผลิตภัณฑ์

ร่างเอกสารการค้นพบที่น่าเชื่อถือจากคำอธิบายบริการโดยไม่ต้องแตะไวยากรณ์ JSON จากนั้นส่งต่อให้ฝ่ายวิศวกรรมตรวจสอบ

ทีมแพลตฟอร์มและ DevOps

ทำให้วิธีที่เอเจนต์ภายในอธิบายเอนด์พอยต์ การยืนยันตัวตน และสกิลเป็นมาตรฐานก่อนที่จะเข้าสู่แคตตาล็อกเอเจนต์ของบริษัทหรือไปป์ไลน์ CI

ผู้เผยแพร่มาร์เก็ตเพลส

เตรียมข้อมูลเมตาผู้ให้บริการ แท็กสกิล และการประกาศด้านความปลอดภัยที่ผู้ตรวจสอบและระบบจัดอันดับสามารถแยกวิเคราะห์ได้จริง

คำถามที่พบบ่อย

คำถามเกี่ยวกับเครื่องมือสร้าง Agent Card

จัดการสิ่งจำเป็นให้ถูกต้องก่อนที่ไคลเอนต์ A2A จะพบเอนด์พอยต์ของคุณ

A2A Agent Card คืออะไร

A2A Agent Card คือเอกสารการค้นพบ JSON สำหรับเอเจนต์ AI มันสื่อสารตัวตน ข้อมูลผู้ให้บริการ อินเทอร์เฟซที่รองรับ ความสามารถ สกิล โหมดเนื้อหาที่ยอมรับ และข้อกำหนดด้านความปลอดภัยให้กับไคลเอนต์ที่มีศักยภาพ — เทียบเท่ากับ README บวกภาพรวม API สำหรับเอเจนต์ต่อเอเจนต์

ทำไมจึงใช้เครื่องมือสร้าง Agent Card แทนการเขียน JSON ด้วยมือ

Agent Card ที่เขียนด้วยมือมักจะขาดฟิลด์ที่จำเป็น ใช้ชื่อฟิลด์ก่อน v1.0 หรือมีข้อผิดพลาดทางไวยากรณ์ เครื่องมือสร้างจะสร้างรูปแบบ A2A v1.0 ปัจจุบัน — supportedInterfaces, provider.organization, แท็กสกิลที่จำเป็น — และตรวจสอบขณะที่คุณพิมพ์ ดังนั้นข้อผิดพลาดเชิงโครงสร้างจะไม่มีวันไปถึงการใช้งานจริง

Agent Card ที่สร้างขึ้นมุ่งเป้าไปที่ A2A เวอร์ชันใด

เครื่องมือสร้างจะสร้างโครงสร้าง A2A v1.0: อาร์เรย์ supportedInterfaces ที่เรียงลำดับพร้อม protocolBinding และ protocolVersion ต่ออินเทอร์เฟซ, version ของเอเจนต์ระดับบนสุด และ capabilities รวมถึง extendedAgentCard Agent Card ที่มีฟิลด์ url หรือ preferredTransport ระดับบนสุดคือก่อน v1.0

JSON ที่สร้างขึ้นต้องได้รับการตรวจสอบก่อนใช้งานจริงหรือไม่

ใช่ เครื่องมือสร้างจะสร้างเอกสารเริ่มต้นที่ใช้งานได้จริง ไม่ใช่สิ่งทดแทนสัญญาที่ปรับใช้จริงของคุณ ยืนยันว่าเอนด์พอยต์ การเชื่อมโยงโปรโตคอล สกิล และการยืนยันตัวตนตรงกับบริการที่ผู้ใช้จะเข้าถึงจริง

ฉันควรเผยแพร่ Agent Card ที่ไหน

เผยแพร่ JSON ที่ตรวจทานแล้วบนโดเมนเดียวกับบริการ A2A ของคุณที่ https://your-domain/.well-known/agent-card.json ซึ่งเป็นเส้นทาง well-known ที่ลงทะเบียนโดยข้อกำหนด A2A การผสานรวมเก่าจำนวนมากยังตรวจสอบ /.well-known/agent.json ด้วย ดังนั้นการให้บริการทั้งสองจึงเป็นกลยุทธ์การเปลี่ยนผ่านที่ปลอดภัย

พร้อมเผยแพร่

กลับไปที่เครื่องมือสร้าง Agent Card ก่อนเผยแพร่

ทำรายละเอียดให้เสร็จสมบูรณ์ ตรวจสอบ JSON ที่สร้างขึ้น และใช้การตรวจสอบสดก่อนเผยแพร่ Agent Card ของคุณ

เปิดเครื่องมือสร้าง Agent Cardตรวจสอบ JSON

จากบล็อก

คู่มือภาคปฏิบัติสำหรับการค้นพบ A2A เขียนตามข้อกำหนดเวอร์ชัน 1.0

บทความทั้งหมด
How-to

How to create an agent.json file for A2A v1.0

Learn how to create an agent.json file for A2A v1.0, including required Agent Card fields, the well-known URL, response headers, and common mistakes.

11 min readอ่านคู่มือIntegration

Publishing an Agent Card from ADK, LangGraph, CrewAI or Semantic Kernel

Learn how to publish an A2A Agent Card from Google ADK, LangGraph, CrewAI, or Semantic Kernel by mapping framework concepts to standard discovery fields.

10 min readอ่านคู่มือComparison

A2A vs MCP: two protocols solving two different problems

Compare A2A vs MCP: what each protocol connects, where they overlap, and why production AI agent systems often use both for tools and agent collaboration.

9 min readอ่านคู่มือ

บทความเผยแพร่เป็นภาษาอังกฤษ