หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
รายการเอเจนต์ใน 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 |
สตริง | วิธีใช้การดําเนินงาน:
|
ดูตัวอย่าง |
requiresEndUserConsent |
boolean | ไม่ว่าผู้ใช้ปลายทางจะต้องยินยอมก่อนที่ตัวแทนจะสามารถใช้การดําเนินการได้หรือไม่ | ดูตัวอย่าง |
whenCanBeUsed |
สตริง | เมื่อสามารถเรียกใช้การดําเนินงานได้:
|
ดูตัวอย่าง |
connectionProvider |
สตริง | ใครเป็นผู้ให้การเชื่อมต่อสำหรับการดำเนินการ:
|
ดูตัวอย่าง |
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เขตข้อมูลเพื่อทําความเข้าใจจํานวนทรัพยากรที่กําหนดค่าในตัวแทนต่อชนิดได้