สินค้าคงคลังของตัวแทน Microsoft Copilot Studio

รายการเอเจนต์ใน Copilot Studio ช่วยให้ผู้ดูแลระบบไอทีและความปลอดภัยเห็นภาพรวมแบบรวมศูนย์ของเอเจนต์ทั้งหมดที่สร้างขึ้นโดยใช้ Copilot Studio หรือ Agent Builder ภายในเทนเนนต์ รายการครอบคลุมทั้งเอเจนต์ฉบับร่างที่ยังไม่ได้เผยแพร่และเอเจนต์ที่เผยแพร่แล้ว สําหรับแต่ละตัวแทน สินค้าคงคลังแสดงเมตาดาต้าหลัก เช่น ผู้สร้างตัวแทนเมื่อมีการเผยแพร่ครั้งล่าสุด ช่องใดบ้างที่ปรับใช้ วิธีการรับรองความถูกต้องผู้ใช้ ความสามารถ และอื่น ๆ ข้อมูลสินค้าคงคลังจะรีเฟรชโดยอัตโนมัติ และโดยทั่วไปการเปลี่ยนแปลงของตัวแทนจะปรากฏขึ้นภายใน 20 นาที

ผู้ดูแลระบบสามารถใช้ข้อมูลสินค้าคงคลังผ่านหลายวิธี รวมถึงศูนย์การจัดการ Power Platform, Power Platform API และ Azure Resource Graph สําหรับรายการทั้งหมดของวิธีการเข้าถึงและบทบาทที่จําเป็น โปรดดูที่ สินค้าคงคลังของ Power Platform

บทความนี้อธิบายเขตข้อมูลเฉพาะสําหรับตัวแทน Copilot Studio (microsoft.copilotstudio/agents) ในสินค้าคงคลังของ Power Platform สําหรับเขตข้อมูลที่แชร์ที่พร้อมใช้งานบนชนิดทรัพยากรทั้งหมด โปรดดู การอ้างอิง Schema สินค้าคงคลังของ Power Platform

หมายเหตุ

สินค้าคงคลังไม่รวมตัวแทนที่สร้างขึ้นด้วย V1 ของ Copilot Studio (หรือที่เรียกว่าบอทแบบคลาสสิกหรือ Power Virtual Agents) อย่างไรก็ตามคุณยังคงสามารถไปที่ ศูนย์ผู้ดูแลระบบ Power Platform และเลือก Manage>Copilot Studio>Classic chatbots เพื่อดูตัวแทนเหล่านั้น

สําคัญ

บทความนี้มีเอกสารรุ่นพรีวิว Microsoft Copilot Studio และอาจจะมีการเปลี่ยนแปลงในอนาคต

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

หากคุณกำลังสร้างเอเจนต์ที่พร้อมสำหรับการใช้งานจริง โปรดดู ภาพรวมของ Microsoft Copilot Studio

คุณสมบัติของตัวแทน

สินค้าคงคลังมีคุณสมบัติต่อไปนี้สําหรับแต่ละตัวแทน

หมายเหตุ

  • สินค้าคงคลังสะท้อนถึงโครงสร้างของ เวอร์ชันที่เผยแพร่ ของแต่ละตัวแทน หากตัวแทนมีการเปลี่ยนแปลงที่ยกเลิกการเผยแพร่ (แบบร่างที่ใหม่กว่า) สินค้าคงคลังจะไม่แสดงการเปลี่ยนแปลงเหล่านั้นจนกว่าจะมีการเผยแพร่ตัวแทน

  • การกําหนดค่าของเจ้าหน้าที่จะมีผลต่อเขตข้อมูลที่ถูกเติม คุณสมบัติบางอย่างอาจ null ขึ้นอยู่กับวิธีการตั้งค่าตัวแทน ตัวอย่างเช่น isManaged คือ null สำหรับเอเจนต์ที่สร้างใน Agent Builder

คุณสมบัติหลัก

เส้นทางเขตข้อมูล API ชนิดของข้อมูล คำอธิบาย ตัวอย่าง สถานะ
properties.displayName สตริง ชื่อที่ใช้แสดงของเอเจนต์ Customer support agent พร้อมใช้งานโดยทั่วไป
properties.name GUID ID ของตัวแทนในสภาพแวดล้อม Dataverse เฉพาะ (ID บอท CDS) aaaa0000-bb11-2222-33cc-444444dddddd พร้อมใช้งานโดยทั่วไป
properties.createdAt วันที่เวลา วันที่และเวลาที่เอเจนต์ถูกสร้าง 2024-12-13T04:00:00Z พร้อมใช้งานโดยทั่วไป
properties.createdBy GUID Entra ID ของผู้ใช้ที่สร้างตัวแทน aaaa0000-bb11-2222-33cc-444444dddddd พร้อมใช้งานโดยทั่วไป
properties.ownerId สตริง รหัสออบเจ็กต์ (Entra ID) ของเจ้าของปัจจุบันของเอเจนต์ aaaa0000-bb11-2222-33cc-444444dddddd พร้อมใช้งานโดยทั่วไป
properties.environmentId สตริง รหัสของสภาพแวดล้อม Power Platform ที่ประกอบด้วยทรัพยากร aaaa0000-bb11-2222-33cc-444444dddddd พร้อมใช้งานโดยทั่วไป
properties.lastPublishedAt วันที่เวลา วันที่และเวลาที่เผยแพร่เอเจนต์ครั้งล่าสุด หากเอเจนต์ยังคงอยู่ในแบบร่าง ให้เว้นว่าง/null 2026-01-15T10:30:00Z พร้อมใช้งานโดยทั่วไป
properties.createdIn สตริง เครื่องมือการเขียนที่ตัวแทนถูกสร้างขึ้น: Copilot Studio หรือ Microsoft 365 Copilot Agent Builder Copilot Studio พร้อมใช้งานโดยทั่วไป
properties.schemaName สตริง ชื่อสคีมา Dataverse พร้อมใช้งานสําหรับตัวแทน Copilot Studio และตัวแทน Microsoft 365 Copilot Agent Builder cr5e3_agentName พร้อมใช้งานโดยทั่วไป
properties.isQuarantined boolean ตัวแทนนี้ถูกกักกันหรือไม่ false ดูตัวอย่าง
properties.quarantinedAt วันที่เวลา วันและเวลาที่เจ้าหน้าที่ถูกกักกันครั้งล่าสุด 2026-02-01T08:00:00Z ดูตัวอย่าง
properties.isManaged boolean ไม่ว่าตัวแทนเป็นส่วนหนึ่งของโซลูชัน Dataverse ที่มีการจัดการหรือไม่ Null สำหรับเอเจนต์ที่สร้างในตัวสร้างเอเจนต์ false ดูตัวอย่าง

คุณสมบัติข้อมูลประจําตัว Entra

เส้นทางเขตข้อมูล API ชนิดของข้อมูล คำอธิบาย ตัวอย่าง สถานะ
properties.botId สตริง ID ของบอท CDS ในสภาพแวดล้อม aaaa0000-bb11-2222-33cc-444444dddddd พร้อมใช้งานโดยทั่วไป
properties.entraAppId สตริง รหัสการลงทะเบียนแอป Entra ที่เชื่อมโยงกับเอเจนต์ หากมี aaaa0000-bb11-2222-33cc-444444dddddd พร้อมใช้งานโดยทั่วไป
properties.entraAgentId สตริง ID ข้อมูลประจำตัวของเอเจนต์ Entra หากมี aaaa0000-bb11-2222-33cc-444444dddddd พร้อมใช้งานโดยทั่วไป
properties.entraAgentBlueprintId สตริง รหัสพิมพ์เขียวของตัวแทน Entra เมื่อมีอยู่ aaaa0000-bb11-2222-33cc-444444dddddd พร้อมใช้งานโดยทั่วไป

หมายเหตุ

คุณสมบัติข้อมูลประจําตัวทั้งหมดไม่พร้อมใช้งานสําหรับชนิดของตัวแทนทั้งหมด: entraAppId เป็นตัวระบุเดิม ตัวแทนที่ใหม่กว่าใช้ entraAgentId และentraAgentBlueprintId ฟิลด์เหล่านี้จะถูกเติมข้อมูลเฉพาะเมื่อใช้กับเจ้าหน้าที่เฉพาะเท่านั้น ไม่มีคุณสมบัติข้อมูลประจําตัวเหล่านี้ที่นําไปใช้กับตัวแทน Microsoft 365 Copilot Agent Builder

หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับแนวคิดข้อมูลประจําตัวของ Entra โปรดดู การลงทะเบียนแอป ข้อมูลประจําตัวของตัวแทน และการรับรองความถูกต้องสําหรับ Copilot Studio

คุณสมบัติการกําหนดค่า

เส้นทางเขตข้อมูล API ชนิดของข้อมูล คำอธิบาย ตัวอย่าง สถานะ
properties.orchestration สตริง โหมดการเรียงของเอเจนต์ (เรียนรู้เพิ่มเติม ในโหมด Orchestration) Generative ดูตัวอย่าง
properties.model สตริง แบบจําลอง AI ที่ใช้โดยตัวแทน gpt-4o ดูตัวอย่าง
properties.authentication สตริง โหมดการรับรองความถูกต้องที่กําหนดค่าสําหรับตัวแทน (เรียนรู้เพิ่มเติม ในโหมดการรับรองความถูกต้อง) Microsoft Entra ดูตัวอย่าง
properties.channels อาร์เรย์ ชื่อที่แสดงของช่องทางที่มีการเผยแพร่เอเจนต์ ["Teams","SharePoint"] ดูตัวอย่าง
properties.sharedWithViewers วัตถุ จํานวนผู้ใช้ผู้ชมรายบุคคล (userCount) และกลุ่มผู้ชม (groupCount) ที่มีการแชร์ตัวแทนด้วย ถ้าผู้สร้างแชร์ตัวแทนกับผู้เช่า entireTenant ทั้งหมด จะถูกตั้งค่า trueเป็น แม้ว่าผู้ดูแลระบบไม่อนุมัติการแชร์ "groupCount": 0, "userCount": 0, "entireTenant": false ดูตัวอย่าง
properties.sharedWithEditors วัตถุ จํานวนผู้ใช้ตัวแก้ไขรายบุคคล (userCount) และกลุ่มผู้แก้ไข (groupCount) ที่มีการแชร์ตัวแทนด้วย "groupCount": 0, "userCount": 0 ดูตัวอย่าง
properties.capabilitiesCounts วัตถุ จํานวนนับที่แตกต่างกันทั้งหมดของความสามารถที่กําหนดค่าไว้แต่ละชนิด "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 ดูตัวอย่าง

โหมดการเรียง

เขตข้อมูล properties.orchestration ยอมรับค่าต่อไปนี้:

มูลค่า คำอธิบาย
คลาสสิก ตัวแทนใช้การจัดการตามหัวข้อแบบคลาสสิกกับโครงสร้างการสนทนาที่เขียน
สร้างสรรค์ ตัวแทนใช้การจัดกลุ่มที่สร้าง โดยที่แบบจําลอง AI จะเลือกหัวข้อและการดําเนินการแบบไดนามิก

โหมดการรับรองความถูกต้อง

เขตข้อมูล properties.authentication ยอมรับค่าต่อไปนี้:

มูลค่า คำอธิบาย
None ไม่จําเป็นต้องรับรองความถูกต้อง
Microsoft Entra รับรองความถูกต้องผ่าน Microsoft Entra ID
OAuth 2.0 ทั่วไป การรับรองความถูกต้องผ่านผู้ให้บริการ OAuth 2.0 ทั่วไป

ความสามารถของตัวแทน

ส่วนนี้แสดงรายการความสามารถ (เครื่องมือและความรู้) ของตัวแทน ในปัจจุบัน จะแสดงเฉพาะข้อมูลโดยละเอียดเกี่ยวกับตัวเชื่อมต่อที่ใช้โดยตัวแทนและการกําหนดค่าความรู้ตามรายละเอียดในส่วนต่อไปนี้

สินค้าคงคลังมีข้อจํากัดสูงสุด 200 ทรัพยากรของแต่ละชนิดสําหรับแต่ละตัวแทน เรียนรู้เพิ่มเติมใน ข้อจํากัดที่ทราบ

สินค้าคงคลังจะลบทรัพยากรที่ซ้ํากันโดยอัตโนมัติ เช่น ตัวเชื่อมต่อ Power Platform ที่คุณกําหนดค่าสองครั้งในตัวแทนที่มีการกําหนดค่าเดียวกัน

คุณสมบัติของตัวเชื่อมต่อ

สินค้าคงคลังรวมถึงอาร์เรย์ที่เรียกว่า powerPlatformConnectorsซึ่งประกอบด้วยตัวเชื่อมต่อ Power Platform ที่กําหนดค่าในตัวแทน ตัวเชื่อมต่อแต่ละตัวจะถูกระบุโดย ( connectorId สตริงที่มี ID ทรัพยากรของตัวเชื่อมต่อ ตัวอย่างเช่น shared_excelonlinebusiness) สำหรับตัวเชื่อมต่อที่กำหนดค่าไว้แต่ละรายการ จะมีรายการของ operations ที่กำหนดค่าไว้ รายการมีคุณสมบัติต่อไปนี้:

ทรัพย์สิน ชนิดของข้อมูล คำอธิบาย สถานะ
OperationId สตริง รหัสของการดําเนินการเฉพาะภายในตัวเชื่อมต่อ ตัวอย่างเช่น AddRowV2 ดูตัวอย่าง
createdBy GUID ผู้ใช้ที่กําหนดค่าการดําเนินการ ดูตัวอย่าง
isEnabled boolean การดําเนินการเชื่อมต่อถูกเปิดใช้งานในปัจจุบันหรือไม่ ดูตัวอย่าง
usedAs สตริง วิธีใช้การดําเนินงาน:
  • Tool ถ้ามีการกําหนดค่าเป็นเครื่องมือทั่วไป
  • Topic Tool ถ้ากําหนดค่าเป็นเครื่องมือในหัวข้อเฉพาะ
  • Knowledge ถ้ามีการกําหนดค่าตัวเชื่อมต่อเป็นแหล่งความรู้
ดูตัวอย่าง
requiresEndUserConsent boolean ไม่ว่าผู้ใช้ปลายทางจะต้องยินยอมก่อนที่ตัวแทนจะสามารถใช้การดําเนินการได้หรือไม่ ดูตัวอย่าง
whenCanBeUsed สตริง เมื่อสามารถเรียกใช้การดําเนินงานได้:
  • Anytime หากเครื่องมือนี้พร้อมใช้งานสำหรับเอเจนต์โดยไม่มีข้อจำกัด
  • ViaDirectReferenceOnly ถ้าเอเจนต์ใช้เครื่องมือเฉพาะเมื่อผู้สร้างกําหนดค่าอย่างชัดเจนในหัวข้อเฉพาะ
  • Conditional ถ้าตัวแทนสามารถใช้เครื่องมือตามตรรกะที่กําหนดไว้ล่วงหน้าโดยผู้สร้าง
ดูตัวอย่าง
connectionProvider สตริง ใครเป็นผู้ให้การเชื่อมต่อสำหรับการดำเนินการ:
  • User ถ้าผู้ใช้ปลายทางมีข้อมูลประจําตัวในรันไทม์
  • Maker ถ้าผู้สร้างตั้งค่าการเชื่อมต่อในเวลาการเขียน
ดูตัวอย่าง
connectionIdSharedByMaker GUID รหัสการเชื่อมต่อ ซึ่งจะถูกกรอกเฉพาะเมื่อ connectionProvider = Maker ดูตัวอย่าง
ตัวอย่าง
{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

คุณสมบัติความรู้

สินค้าคงคลังประกอบด้วยคุณสมบัติต่อไปนี้สําหรับความรู้:

ทรัพย์สิน ชนิดของข้อมูล คำอธิบาย สถานะ
IsWebSearchEnabledForKnowledge boolean True ถ้าตัวแทนสามารถใช้การค้นหาเว็บเป็นแหล่งข้อมูลความรู้ ดูตัวอย่าง

ข้อจำกัดที่ทราบ

  • ไม่มีการติดตามตัวแทน V1 - สินค้าคงคลังไม่รวมตัวแทนที่สร้างขึ้นด้วยรันไทม์ Power Virtual Agents V1 เดิม จะติดตามเฉพาะเจ้าหน้าที่ V2 (Copilot Studio) เท่านั้น
  • คุณสมบัติของข้อมูลประจําตัวอาจไม่พร้อมใช้งานสําหรับตัวแทนทั้งหมด - entraAgentId เขตข้อมูล และ entraAgentBlueprintId จะมีข้อมูลสําหรับตัวแทนที่เตรียมใช้งานด้วยแบบจําลองข้อมูลประจําตัวของตัวแทน Entra ที่ใหม่กว่า เอเจนต์รุ่นเก่าอาจมีเพียง entraAppId เท่านั้น และเอเจนต์ Microsoft 365 Copilot Agent Builder ไม่มีคุณสมบัติข้อมูลประจำตัวเหล่านี้
  • จํานวนความสามารถ - สินค้าคงคลังมีขีดจํากัดสูงสุด 200 ทรัพยากรของแต่ละชนิดต่อตัวแทน ถ้าตัวแทนมีทรัพยากรที่กําหนดค่าไว้มากกว่า 200 รายการจากชนิดเฉพาะ (ตัวอย่างเช่น ตัวเชื่อมต่อ Power Platform) สินค้าคงคลังจะแสดง 200 แบบสุ่ม ผู้ดูแลระบบสามารถใช้ capabilitiesCounts เขตข้อมูลเพื่อทําความเข้าใจจํานวนทรัพยากรที่กําหนดค่าในตัวแทนต่อชนิดได้