เครื่องมือสร้าง 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