กําหนด Microsoft 365 Copilot เองด้วยตัวแทน

Microsoft 365 Copilot ใน Power Apps ช่วยให้ผู้ใช้สามารถโต้ตอบกับตัวแทนแบบกําหนดเองที่ขยายสิ่งที่ Copilot สามารถทําได้ โดยการกําหนดตัวแทนคุณสามารถสร้างประสบการณ์ที่เหมาะสมกับกระบวนการทางธุรกิจและข้อมูลขององค์กรของคุณ สําหรับข้อมูลเพิ่มเติม ให้ดู ใช้ตัวแทนใน Microsoft 365 Copilot

บทความนี้อธิบายชนิดของตัวแทนที่คุณสามารถสร้างสําหรับ Microsoft 365 Copilot ใน Power Apps และช่วยให้คุณเลือกวิธีการที่เหมาะสมสําหรับสถานการณ์ของคุณ

เลือกชนิดของตัวแทน

ตารางต่อไปนี้เปรียบเทียบชนิดของตัวแทนที่คุณสามารถสร้างได้

ชนิดของตัวแทน คำอธิบาย กรณีการใช้งานทั่วไป
เอเจนต์เชิงประกาศ สร้างด้วยเครื่องมือและเทมเพลตที่มีรหัสต่ําสําหรับการตั้งค่าด่วนของสถานการณ์ทั่วไปใน Microsoft 365 Copilot ทํางานตามปกติโดยอัตโนมัติ ตอบคําถามที่ถามบ่อย และให้เวิร์กโฟลว์ที่แนะนํา
เอเจนต์โปรแกรมแบบกำหนดเอง สร้างขึ้นด้วยตรรกะแบบกําหนดเองและการรวมสําหรับความสามารถขั้นสูงที่ปรับให้เหมาะกับธุรกิจของคุณ กระบวนการทางธุรกิจที่ซับซ้อน การรวมข้อมูลแบบกําหนดเอง และระบบอัตโนมัติพิเศษ
ตัวแทน Copilot Studio สร้างและจัดการใน Microsoft Copilot Studio ด้วยการผสานรวมกับ Teams และ Microsoft 365 เพื่อประสบการณ์การสนทนา แชทบอทแบบโต้ตอบ การทํางานร่วมกันเป็นทีม และการสนับสนุนส่วนบุคคลภายในแอป Microsoft 365

เมื่อต้องการค้นหาตัวเลือกที่ดีที่สุดสําหรับองค์กรของคุณ ให้ใช้ทรัพยากรเหล่านี้:

วิธีหนึ่งในการสร้างตัวแทนแบบประกาศสำหรับแอปที่ขับเคลื่อนด้วยโมเดลคือการเปิด Copilot โดยตรงในแอปของคุณ สําหรับข้อมูลเพิ่มเติม ให้ดู เปิดใช้งานแอปของคุณสําหรับ Copilot

Xrm.Copilot APIs

API ไคลเอ็นต์Xrm.Copilot.*ช่วยให้นักพัฒนารวม Microsoft 365 Copilot เข้ากับประสบการณ์การใช้งานแอปแบบจําลองข้อมูลได้โดยตรง ด้วย API เหล่านี้ แอปของคุณสามารถโต้ตอบกับ Copilot และตอบสนองต่อการดําเนินการที่ขับเคลื่อนด้วย Copilot ดังนั้นคุณสามารถสร้างสถานการณ์เอเจนต์ที่สมบูรณ์กว่าเดิม

สำหรับรายละเอียดทั้งหมดของ API โปรดดู Xrm.Copilot (ข้อมูลอ้างอิง Client API) ในแอปแบบจำลองข้อมูล

API เหล่านี้ช่วยให้คุณสามารถ:

  • ส่งพร้อมท์ไปยัง Copilot ใช้ sendPromptToM365Copilot เพื่อเริ่มการโต้ตอบ Copilot จากแอปของคุณ
  • เปิดและควบคุมบานหน้าต่างด้าน Copilot ใช้ openM365CopilotPanel เพื่อให้แน่ใจว่าบานหน้าต่าง Copilot จะมองเห็นได้เมื่อจําเป็น
  • ส่งผ่านบริบทแอปไปยัง Copilot ใช้ updateContext (ตัวอย่าง) เพื่อส่งสัญญาณพื้นฐานเพิ่มเติมจากแอปของคุณ
  • ทํางานกับเจ้าหน้าที่ ใช้ getCurrentAgent เพื่อตรวจสอบว่าตัวแทนใดที่ใช้งานอยู่
  • จัดการการดำเนินการของ Copilot ในแอปของคุณ ใช้ addActionHandler เพื่อลงทะเบียนตัวจัดการแบบกําหนดเองที่ประมวลผลการดําเนินการที่ส่งจาก Copilot การตอบสนอง

เมื่อทํางานร่วมกัน API เหล่านี้จะเชื่อมต่อการตอบสนอง Copilot กลับไปยังตรรกะแอปของคุณ เพื่อให้ตัวแทนสามารถขับเคลื่อนการอัปเดต UI ทริกเกอร์เวิร์กโฟลว์ หรือเรียกใช้ตรรกะทางธุรกิจแบบกําหนดเอง

จัดการการดําเนินการ Copilot ด้วย addActionHandler

addActionHandlerใช้ API เมื่อแอปของคุณต้องการจัดการการดําเนินการที่มีโครงสร้างที่ Copilot ปล่อยออกมา

เมื่อคุณสร้างส่วนข้อมูลของการดำเนินการ:

  • ตั้งค่าtypeเป็น PowerApps เพื่อกําหนดเป้าหมายโฮสต์ Power Apps
  • ตั้งค่า action (ตัวอย่างเช่น MyNamespace.MyMessage) เป็น actionId ที่คุณลงทะเบียนในaddActionHandler
  • ใช้ actionData สำหรับเพย์โหลดที่โค้ดของคุณประมวลผลและส่งต่อไปยังโฮสต์ Power Apps

ส่วนต่อไปนี้แสดงสองสถานการณ์ที่ได้รับการสนับสนุน

การ์ดที่ปรับเปลี่ยนได้

การตอบกลับของ Copilot อาจมี การ์ดที่ปรับเปลี่ยนได้ ที่มีปุ่ม Action.Submit ซึ่งส่งข้อความการดำเนินการไปยังโฮสต์ Power Apps

ตัวอย่าง:

{
  "type": "AdaptiveCard",
  "$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
  "version": "1.5",
  "body": [
    {
      "type": "TextBlock",
      "text": "Click Go and I will send data to the host to process.",
      "wrap": true,
      "id": "txtSendMessage"
    },
    {
      "type": "ActionSet",
      "actions": [
        {
          "type": "Action.Submit",
          "title": "Go",
          "id": "btnGo",
          "data": {
            "type": "PowerApps",
            "action": "MyNamespace.MyMessage",
            "actionData": {
              "foo": "bar"
            }
          }
        }
      ]
    }
  ]
}

แอป MCP

การตอบสนอง Copilot อาจรวมถึง HTML ที่ส่งข้อความการดําเนินการไปยังโฮสต์ Power Apps

ตัวอย่าง:

<Button
  appearance="outline"
  icon={<ArrowLeft24Regular />}
  onClick={() => {
    try {
      const message = {
        eventName: 'powerapps.copilot.chat.action',
        action: 'MyNamespace.MyMessage',
        actionData: {
          foo: 'bar'
        },
      };
      window.parent.parent.postMessage(message, '*');
    } catch (error) {
      // eslint-disable-next-line no-console
      console.error('Error posting HOST_ACTION message to parent window:', error);
    }
  }}
>
  Test
</Button>

ตั้งค่าตัวแทนเริ่มต้น

หากคุณสร้างตัวแทนแบบกําหนดเองให้มาเป็นแอปแบบจําลองของคุณ คุณสามารถตั้งค่าเป็นตัวแทนเริ่มต้นเพื่อให้โหลดโดยอัตโนมัติเมื่อแอปและบานหน้าต่างด้าน Copilot เปิดขึ้น

เมื่อคุณตั้งค่าตัวแทนเริ่มต้น:

  • เลือกตัวแทนของคุณโดยไม่มีการดําเนินการใดๆ จากผู้ใช้
  • ผู้ใช้จะเข้าสู่ประสบการณ์การใช้งานที่ปรับแต่งไว้สำหรับแอปที่คุณออกแบบได้โดยตรง
  • เวิร์กโฟลว์เฉพาะแอปและคําแนะนําพร้อมทันที Copilot เปิด

ตัวแทนเริ่มต้นจะเป็นประโยชน์โดยเฉพาะอย่างยิ่งสําหรับตัวแทนที่เน้นสถานการณ์ที่ขยายประสบการณ์หลักของแอป

สกรีนช็อตที่แสดงวิธีการตั้งค่าตัวแทนเริ่มต้นสําหรับ Microsoft 365 Copilot ในแอปแบบจําลองข้อมูล

ข้อจำกัด

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