ปรับแต่ง Microsoft Copilot ด้วยเอเจนต์

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

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

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

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

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

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

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

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

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

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

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

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

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

Xrm.Copilot APIs

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

เมื่อคุณใช้ API เหล่านี้กับเอเจนต์เริ่มต้น จะทำให้รูปแบบ agent mode สมบูรณ์: เอเจนต์ของคุณคือจุดเริ่มต้น แอปของคุณสามารถส่งพร้อมท์และบริบทไปยัง Microsoft Copilot และ Microsoft Copilot สามารถเรียกใช้แอ็กชันกลับภายในแอปของคุณได้

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

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

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

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

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

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

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

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

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

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

การตอบกลับของ Microsoft 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

การตอบสนอง Microsoft 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>

ข้อจำกัด

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

ข้อมูลที่เกี่ยวข้อง

• เพิ่ม Microsoft Copilot สำหรับผู้ใช้แอปในแอปแบบจำลอง
• ใช้ Microsoft Copilot ในแอปแบบจําลองข้อมูล
• เพิ่ม Microsoft Copilot สําหรับผู้ใช้แอปในแอปแบบแคนวาส (ตัวอย่าง)
• ใช้ Microsoft Copilot ในแอปแบบแคนวาส (ตัวอย่าง)
• ปรับแต่ง Microsoft Copilot ด้วยเอเจนต์ในแอปพื้นที่ทำงาน