ปรับใช้เอเจนต์ของคุณกับ Azure ด้วยตนเอง

การเรียกใช้เอเจนต์ของ SDK เอเจนต์สำหรับ Microsoft 365 บน Azure จําเป็นต้องมีขั้นตอนต่อไปนี้:

เอกสารนี้ครอบคลุมการปรับใช้เอเจนต์ที่คุณสร้างไปยัง Azure and Teams หรือ Microsoft Copilot

ถ้าคุณยังไม่ได้สร้างตัวแทน เริ่มต้นด้วย เริ่มต้นใช้งานด่วน: สร้างและทดสอบตัวแทนพื้นฐานโดยใช้ C#

เผยแพร่ตัวแทนของคุณไปยัง Azure ในฐานะเว็บแอป

  1. นำโค้ดตัวแทนของคุณไปปรับใช้บน Azure เอเจนต์ SDK เอเจนต์เป็นเว็บแอปพลิเคชัน ในการเผยแพร่เอเจนต์ของคุณ คุณสามารถใช้วิธีการที่คุณใช้เพื่อปรับใช้เว็บแอปพลิเคชันกับ Azure ได้ตามปกติ:

    • ปรับใช้เป็นแพคเกจ ZIP ไปยังแอป Azure App Service
    • Visual Studio เผยแพร่ไปยังแอป Azure App Service หรือคอนเทนเนอร์
    • การปรับใช้คอนเทนเนอร์อื่นๆ ที่ได้รับการสนับสนุนโดย Azure
    • การปรับใช้ชุดเครื่องมือเอเจนต์ของ Microsoft 365

สำคัญ

ถ้าคุณกําลังใช้แอป Azure App Service และข้อมูลประจําตัวภายนอกหรือข้อมูลประจําตัว User-Assigned ที่มีการจัดการ คุณจะต้องเพิ่มข้อมูลประจําตัวนั้นภายใต้ การตั้งค่า>Identity

เมื่อมีการปรับใช้โค้ดของเอเจนต์ของคุณ จะมี URL พื้นฐาน เช่น example.azurewebsites.net

  1. ใน Azure ไปที่ทรัพยากรบอท Azure ของคุณ ภายใต้ การกําหนดค่า เปลี่ยน ตำแหน่งข้อมูลการส่งข้อความ เป็น https://{yourwebsite}/api/messages แทนที่ {yourwebsite} ด้วย URL พื้นฐานของเว็บแอปของคุณ

ทดสอบในการสนทนาบนเว็บ

เมื่อต้องการดูข้อความของคุณในการสนทนาบนเว็บ เลือก ทดสอบในการสนทนาบนเว็บ ในทรัพยากรบอท Azure และส่งข้อความถึงเอเจนต์ของคุณ

เตรียม Teams และ Microsoft Copilot manifest ของคุณ

สําหรับ Microsoft Teams และ Microsoft Copilot คุณต้องสร้างและอัปโหลด manifest ไม่สามารถให้ตัวอย่าง manifest ที่ครอบคลุมความต้องการทั้งหมดของ Teams หรือ Microsoft Copilot ได้ คุณลักษณะของ Teams จําเป็นต้องมีเนื้อหาไฟล์กำกับที่เฉพาะเจาะจง

ขั้นตอนเหล่านี้ให้ภาพรวมของเอเจนต์ Teams ที่มีสไตล์ "แชท" พื้นฐาน

  1. สร้างโฟลเดอร์ที่ว่างเปล่าในโครงการของคุณ
  2. คัดลอกเนื้อหาของ ไฟล์กำกับ Teams ลงในโฟลเดอร์
  3. ในโฟลเดอร์ เปิด manifest.json และทําการแก้ไขต่อไปนี้:
    • ทุกที่ ที่คุณเห็นสตริงตัวยึด <<AAD_APP_CLIENT_ID>> ให้แทนที่ด้วย ClientId สําหรับทรัพยากรบอท Azure ของคุณ
    • แทนที่ <<BOT_DOMAIN>> ด้วย URL พื้นฐานของเอเจนต์ของคุณ
    • บีบอัดเนื้อหาของโฟลเดอร์เพื่อสร้าง manifest.zip ที่มีเนื้อหา:
      • manifest.json
      • outline.png
      • color.png

ปรับใช้กับ Microsoft 365

  1. ตรวจสอบให้แน่ใจว่าทรัพยากร Azure Bot ของคุณมีแชนเนล Microsoft Teams ที่เพิ่มภายใต้ช่อง

  2. นําทางไปยัง พอร์ทัลผู้ดูแลระบบ Microsoft (MAC)

  3. ภายใต้ การตั้งค่า และ แอปรวม เลือก อัปโหลดแอปที่กําหนดเอง

  4. เลือก manifest.zip ที่สร้างในส่วนก่อนหน้า และอัปโหลดไฟล์

หลังจากเวลาสั้น ๆ เอเจนต์จะปรากฏใน Microsoft Teams และ Microsoft Copilot