เผยแพร่เอเจนต์ไปยังศูนย์การจัดการ Microsoft

ใช้ a365 publish คำสั่งเพื่อจัดแพคเกจเอเจนต์ของคุณ แล้วอัปโหลดแพคเกจไปยังศูนย์การจัดการ Microsoft 365 หลังจากเผยแพร่แล้ว คุณสามารถสร้างอินสแตนซ์ของเอเจนต์ภายในองค์กรของคุณและบริหารจัดการเอเจนต์ได้

ข้อกำหนดเบื้องต้น

ก่อนที่คุณจะเริ่มต้น โปรดตรวจสอบให้แน่ใจว่า คุณมีรายการต่อไปนี้:

บัญชีและสิทธิ์ที่จำเป็น

  • ผู้เช่า Microsoft 365 ที่มีหนึ่งในบทบาทต่อไปนี้ (จำเป็นสำหรับขั้นตอนการอัปโหลดในศูนย์การจัดการ Microsoft 365):

    • ผู้ดูแลระบบ Global

เครื่องมือที่จำเป็น

  • A365 CLI ที่ติดตั้งแล้ว (Agent 365 CLI)

ขั้นตอนการตั้งค่าที่จำเป็น

ก่อนเผยแพร่ ให้ทำตามขั้นตอนเหล่านี้:

  1. สร้างพิมพ์เขียวเอเจนต์ - ทำตามขั้นตอนการตั้งค่าเพื่อสร้างพิมพ์เขียวเอเจนต์ของคุณ
  2. ทดสอบเอเจนต์ภายในเครื่อง - ตรวจสอบว่าเอเจนต์ของคุณทำงานถูกต้องโดยใช้ Agents Playground (ดู ทดสอบเอเจนต์ภายในเครื่อง)
  3. เตรียมไฟล์การกำหนดค่า - ตรวจสอบให้แน่ใจว่า a365.config.json และ a365.generated.config.json เป็นเวอร์ชันล่าสุด

คำสั่งการเผยแพร่

เรียกใช้คำสั่ง a365 publish:

a365 publish

หมายเหตุ

การเรียกใช้ a365 publish -h จะแสดงตัวเลือกทั้งหมดที่คำสั่งนี้รองรับ

สิ่งที่คำสั่งนี้ทำ:

  1. อัปเดตไฟล์กำกับ - อัปเดต manifest.json ด้วย ID พิมพ์เขียวเอเจนต์ของคุณ
  2. สร้างแพคเกจ - แพคเกจ manifest.json และไอคอนเป็น manifest.zip
  3. พิมพ์คำสั่ง - แสดงคำสั่งทีละขั้นตอนสำหรับการอัปโหลดผ่านศูนย์การจัดการ Microsoft 365

หมายเหตุ

คำสั่ง a365 publish ใช้ได้กับทั้งเอเจนต์และเพื่อนร่วมทีม AI สำหรับเอเจนต์ที่ถูกจัดเตรียมโดยใช้ --agent-name (config-free) ให้ตรวจสอบว่า a365.generated.config.json มีอยู่ในไดเรกทอรีที่คุณใช้งานก่อนที่จะรัน a365 publish เนื่องจากคำสั่งนี้จะอ่านรหัสแบบพิมพ์เขียวจากไฟล์นี้

อัปโหลดไปที่ศูนย์จัดการ

หลังจาก a365 publish เสร็จสิ้นแล้ว ให้ปฏิบัติตามคำสั่งที่แสดงผลเพื่ออัปโหลดเอเจนต์ของคุณ:

  1. ไปที่ ศูนย์จัดการ Microsoft 365
  2. ไปที่ เอเจนต์>เอเจนต์ทั้งหมด
  3. เลือก อัปโหลดเอเจนต์แบบกำหนดเอง
  4. อัปโหลดไฟล์ manifest.zip จากโฟลเดอร์ manifest ในโปรเจ็กต์ของคุณ

สำหรับข้อมูลเพิ่มเติม ดู อัปโหลดเอเจนต์ไปยังศูนย์การจัดการ Microsoft 365

ตรวจสอบการเผยแพร่ที่สำเร็จ

ใช้รายการตรวจสอบต่อไปนี้เพื่อยืนยันว่า เอเจนต์ ของคุณเผยแพร่สำเร็จแล้ว:

✅ CLI เผยแพร่สำเร็จ
✅ โฟลเดอร์ manifest ที่สร้างพร้อมกับ manifest.json และ manifest.zip
✅ เอเจนต์ปรากฏในศูนย์การจัดการ Microsoft

เอาต์พุต CLI

คุณจะเห็นข้อความเอาต์พุตเหล่านี้เมื่อคำสั่งเผยแพร่สำเร็จ:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ มีการแสดงคำสั่งในการอัปโหลดทีละขั้นตอน

หากคำสั่งล้มเหลว ให้ตรวจสอบข้อความข้อผิดพลาดและให้แน่ใจว่าคุณได้ตั้งค่าพิมพ์เขียวเรียบร้อยแล้ว

ข้อผิดพลาดที่เป็นไปได้:

ข้อผิดพลาด ขั้นตอนในการแก้ไข
Agent blueprint ID not found เรียกใช้ a365 setup เพื่อตั้งค่าพิมพ์เขียวให้เสร็จสมบูรณ์
Permissions missing ดำเนินการตั้งค่าอีกครั้งด้วยคำสั่ง a365 setup permissions

ทำตามขั้นตอนเหล่านี้ เมื่อการเผยแพร่ล้มเหลว

ไฟล์รายการทรัพยากร

คุณสามารถทดสอบไฟล์ต่อไปนี้ในโฟลเดอร์ manifest โดยใช้คำสั่ง PowerShell Test-Path

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

หมายเหตุ

ถ้าคุณไม่เห็นไฟล์เหล่านี้ ให้ลองเรียกใช้ a365 publishคำสั่ง อีกครั้ง

เอเจนต์ปรากฏในศูนย์การจัดการ

หมายเหตุ

หลังจากอัปโหลด อาจใช้เวลา 5-10 นาที กว่าเอเจนต์ของคุณจะปรากฏในศูนย์ผู้ดูแลระบบและ Teams ความล่าช้านี้เป็นเรื่องปกติ

ตรวจสอบว่าเอเจนต์ของคุณปรากฏอยู่โดยใช้ขั้นตอนเหล่านี้:

  1. ไปที่ ศูนย์การจัดการ Microsoft 365
  2. ไปที่ เอเจนต์>เอเจนต์ทั้งหมด
  3. เอเจนต์ของคุณจะปรากฏในรายการ

ตารางต่อไปนี้แสดงรายละเอียดที่คุณสามารถค้นหาได้:

ฟิลด์ สิ่งที่ต้องตรวจสอบ
ชื่อ ชื่อเอเจนต์ของคุณ (จาก manifest.json)
เวอร์ชัน หมายเลขเวอร์ชัน (ตัวอย่างเช่น 1.0.0)
ผู้เผยแพร่ ชื่อองค์กรของคุณ
ความพร้อมใช้งาน ผู้ใช้ที่มี/ทั้งหมด

ดูเพิ่มเติม

ขั้นตอนถัดไป

หลังจากที่คุณเผยแพร่เอเจนต์ของคุณ ให้สร้างอินสแตนซ์เพื่อให้คุณสามารถกำหนดค่าและใช้งานในผู้เช่าของคุณได้

สร้างอินสแตนซ์ของเอเจนต์

กำลังแก้ไขปัญหา

ปัญหาทั่วไปในการเผยแพร่เอเจนต์ไปยังศูนย์การจัดการ Microsoft 365

เคล็ดลับ

คู่มือการแก้ไขปัญหา Agent 365 ประกอบด้วยคำแนะนำการแก้ไขปัญหาระดับสูง แนวทางปฏิบัติที่ดีที่สุด และลิงก์ไปยังเนื้อหาการแก้ไขปัญหาสำหรับแต่ละส่วนของวงจรการพัฒนา Agent 365

คำสั่งเผยแพร่ล้มเหลว

อาการ:

  • เกิดข้อผิดพลาดระหว่าง a365 publish
  • ยังไม่ได้สร้าง manifest.zip

สาเหตุหลัก:

  • การตั้งค่าเสร็จสมบูรณ์
  • ข้อผิดพลาดในการตรวจสอบไฟล์กำกับ
  • สิทธิ์ที่ไม่เพียงพอ

การแก้ไขปัญหา:

  1. ตรวจสอบว่าการตั้งค่าเสร็จสมบูรณ์แล้ว

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. เรียกใช้ คำสั่งเผยแพร่ และทำตามพร้อมท์

การอัปโหลดล้มเหลวในศูนย์การจัดการ

อาการ:

  • เกิดข้อผิดพลาดระหว่างการอัปโหลด manifest.zip ในศูนย์การจัดการ Microsoft 365
  • เอเจนต์ไม่ปรากฏขึ้นหลังจากอัปโหลด

สาเหตุหลัก:

  • สิทธิ์ไม่เพียงพอในศูนย์การจัดการ
  • manifest.zip ไม่ถูกต้องหรือล้าสมัย

การแก้ไขปัญหา:

  1. ตรวจสอบให้แน่ใจว่าคุณมีบทบาทผู้ดูแลระบบทั่วไป
  2. เรียกใช้ a365 publish อีกครั้งเพื่อสร้าง manifest.zip ใหม่
  3. ลองอัปโหลดอีกครั้งตามขั้นตอนการอัปโหลด

สำหรับความช่วยเหลือเพิ่มเติม ดู อัปโหลดเอเจนต์ไปยังศูนย์การจัดการ Microsoft 365

  • Last updated on