บัญชีรายการเอเจนต์ Microsoft Copilot Studio

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

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

บทความนี้อธิบายฟิลด์เฉพาะสำหรับเอเจนต์ Copilot Studio (microsoft.copilotstudio/agents) ในบัญชีรายการ Power Platform สำหรับฟิลด์ที่ใช้ร่วมกันในทรัพยากรทุกประเภท ดูได้ที่ การอ้างอิงสคีมาบัญชีรายการ Power Platform

หมายเหตุ

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

สำคัญ

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

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

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

คุณสมบัติของเอเจนต์

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

หมายเหตุ

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

  • การกำหนดค่าของเอเจนต์มีผลต่อฟิลด์ที่ได้รับการเติมข้อมูล คุณสมบัติบางอย่างอาจเป็น null ขึ้นอยู่กับการตั้งค่าของเอเจนต์ ตัวอย่างเช่น isManaged มีค่าเป็น null สำหรับเอเจนต์ที่สร้างขึ้นในตัวสร้างเอเจนต์

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

พาธของฟิลด์ API ชนิดข้อมูล คำอธิบาย ตัวอย่าง สถานะ
properties.displayName สตริง ชื่อที่แสดงของเอเจนต์ Customer support agent พร้อมใช้งานโดยทั่วไป
properties.name GUID รหัสของเอเจนต์ในสภาพแวดล้อม Dataverse เฉพาะ (รหัสบอท CDS) aaaa0000-bb11-2222-33cc-444444dddddd พร้อมใช้งานโดยทั่วไป
properties.createdAt datetime วันที่และเวลาที่มีการสร้างเอเจนต์ 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 datetime วันที่และเวลาที่เผยแพร่เอเจนต์ครั้งล่าสุด หากเอเจนต์ยังคงอยู่ในแบบร่าง ให้เว้นว่าง/null 2026-01-15T10:30:00Z พร้อมใช้งานโดยทั่วไป
properties.createdIn สตริง เครื่องมือที่ใช้สร้างเอเจนต์: Copilot Studio หรือตัวสร้างเอเจนต์ Microsoft 365 Copilot Copilot Studio พร้อมใช้งานโดยทั่วไป
properties.schemaName สตริง ชื่อสคีมา Dataverse พร้อมใช้งานสำหรับเอเจนต์ Copilot Studio และเอเจนต์ของตัวสร้างเอเจนต์ Microsoft 365 Copilot cr5e3_agentName พร้อมใช้งานโดยทั่วไป
properties.isQuarantined แบบบูลีน เอเจนต์ถูกกักกันอยู่ในขณะนี้หรือไม่ false พรีวิว
properties.quarantinedAt datetime วันที่และเวลาที่กักกันเอเจนต์ครั้งล่าสุด 2026-02-01T08:00:00Z พรีวิว
properties.isManaged แบบบูลีน เอเจนต์เป็นส่วนหนึ่งของโซลูชัน Dataverse ที่มีการจัดการหรือไม่ Null สำหรับเอเจนต์ที่สร้างในตัวสร้างเอเจนต์ false พรีวิว

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

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

หมายเหตุ

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

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

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

พาธของฟิลด์ API ชนิดข้อมูล คำอธิบาย ตัวอย่าง สถานะ
properties.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 ยอมรับค่าดังต่อไปนี้:

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

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

ฟิลด์ properties.authentication ยอมรับค่าดังต่อไปนี้:

Value คำอธิบาย
ไม่มี ไม่ต้องมีการรับรองความถูกต้อง
Microsoft Entra การรับรองความถูกต้องผ่าน Microsoft Entra ID
OAuth 2.0 ทั่วไป การรับรองความถูกต้องผ่านผู้ให้บริการ OAuth 2.0 ทั่วไป

ความสามารถของเอเจนต์

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

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

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

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

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

คุณสมบัติ ชนิดข้อมูล คำอธิบาย สถานะ
OperationId สตริง รหัสของการดำเนินการเฉพาะภายในตัวเชื่อมต่อ; ตัวอย่างเช่น AddRowV2 พรีวิว
createdBy GUID ผู้ใช้ที่กำหนดค่าการดำเนินการ พรีวิว
isEnabled แบบบูลีน ขณะนี้เปิดใช้งานการทํางานของตัวเชื่อมต่อหรือไม่ พรีวิว
usedAs สตริง ลักษณะการใช้งานของการดำเนินการ:
  • Tool หากกำหนดค่าเป็นเครื่องมือทั่วไป
  • Topic Tool หากกำหนดค่าเป็นเครื่องมือในหัวข้อเฉพาะ
  • Knowledge หากตัวเชื่อมต่อถูกกำหนดค่าเป็นแหล่งความรู้
 พรีวิว
requiresEndUserConsent แบบบูลีน ผู้ใช้ปลายทางต้องยินยอมก่อนหรือไม่เอเจนต์จึงจะสามารถใช้การดำเนินการได้ พรีวิว
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 แบบบูลีน เป็นจริง หากเอเจนต์สามารถใช้การค้นหาเว็บเป็นแหล่งความรู้ พรีวิว

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

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

เนื้อหาที่เกี่ยวข้อง

  • Last updated on