หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บทความนี้อธิบายเขตข้อมูลเฉพาะสําหรับตัวแทน Copilot Studio (microsoft.copilotstudio/agents) ในสินค้าคงคลังของ Power Platform สําหรับเขตข้อมูลที่แชร์ที่พร้อมใช้งานบนชนิดทรัพยากรทั้งหมด โปรดดู การอ้างอิง Schema สินค้าคงคลังของ Power Platform สําหรับภาพรวมของคุณลักษณะสินค้าคงคลัง ให้ดู สินค้าคงคลังของ Power Platform
คุณสมบัติหลัก
| เส้นทางเขตข้อมูล API | ชนิดข้อมูล | คำอธิบาย | ตัวอย่าง | สถานะ |
|---|---|---|---|---|
properties.ownerId |
สตริง | ID ออบเจ็กต์ของเจ้าของทรัพยากร | aaaa0000-bb11-2222-33cc-444444dddddd |
พร้อมใช้งานโดยทั่วไป |
properties.environmentId |
สตริง | รหัสของสภาพแวดล้อมที่ประกอบด้วยทรัพยากร | aaaa0000-bb11-2222-33cc-444444dddddd |
พร้อมใช้งานโดยทั่วไป |
properties.lastPublishedAt |
วันที่เวลา | วันที่และเวลาที่เผยแพร่เอเจนต์ครั้งล่าสุด หากเอเจนต์ยังคงอยู่ในแบบร่าง ให้เว้นว่าง | 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 |
บูลีน | ว่าเจ้าหน้าที่ถูกกักกันหรือไม่ | false |
ดูตัวอย่าง |
properties.quarantinedAt |
วันที่เวลา | วันและเวลาที่เจ้าหน้าที่ถูกกักกันครั้งล่าสุด | 2026-02-01T08:00:00Z |
ดูตัวอย่าง |
properties.isManaged |
บูลีน | ไม่ว่าตัวแทนเป็นส่วนหนึ่งของโซลูชันที่มีการจัดการหรือไม่ | false |
ดูตัวอย่าง |
คุณสมบัติข้อมูลประจําตัว
| เส้นทางเขตข้อมูล API | ชนิดข้อมูล | คำอธิบาย | ตัวอย่าง | สถานะ | พร้อมใช้งานสําหรับ |
|---|---|---|---|---|---|
properties.botId |
สตริง | ID ของบอท CDS ในสภาพแวดล้อม | aaaa0000-bb11-2222-33cc-444444dddddd |
พร้อมใช้งานโดยทั่วไป | ตัวแทน Copilot Studio ตัวแทน Microsoft 365 Copilot Agent Builder |
properties.entraAppId |
สตริง | ID การลงทะเบียนแอป Entra | aaaa0000-bb11-2222-33cc-444444dddddd |
พร้อมใช้งานโดยทั่วไป | ตัวแทน Copilot Studio |
properties.entraAgentId |
สตริง | ID ข้อมูลประจำตัวของตัวแทน Entra | aaaa0000-bb11-2222-33cc-444444dddddd |
พร้อมใช้งานโดยทั่วไป | ตัวแทน Copilot Studio |
properties.entraAgentBlueprintId |
สตริง | รหัสพิมพ์เขียวของตัวแทน Entra | aaaa0000-bb11-2222-33cc-444444dddddd |
พร้อมใช้งานโดยทั่วไป | ตัวแทน Copilot Studio |
Note
เขตข้อมูล entraAppId เป็นตัวระบุเดิม ตัวแทนที่ใหม่กว่าใช้ entraAgentId และ entraAgentBlueprintId แทน ไม่มีคุณสมบัติข้อมูลประจําตัวเหล่านี้ที่นําไปใช้กับตัวแทน Microsoft 365 Copilot Agent Builder
คุณสมบัติการกําหนดค่า
| เส้นทางเขตข้อมูล API | ชนิดข้อมูล | คำอธิบาย | ตัวอย่าง | สถานะ |
|---|---|---|---|---|
properties.orchestration |
สตริง | โหมดการจัดการโอเคสตราของตัวแทน (ดู โหมดการจัดการโอเคสตรา) | Generative |
ดูตัวอย่าง |
properties.model |
สตริง | แบบจําลอง AI ที่ใช้โดยตัวแทน | gpt-4o |
ดูตัวอย่าง |
properties.authentication |
สตริง | โหมดการรับรองความถูกต้องที่กําหนดค่าสําหรับตัวแทน (ดู โหมดการรับรองความถูกต้อง) | Microsoft Entra |
ดูตัวอย่าง |
properties.channels |
อาร์เรย์ | ชื่อที่แสดงของช่องทางที่มีการเผยแพร่เอเจนต์ | ["Teams","SharePoint"] |
ดูตัวอย่าง |
โหมดการเรียง
ค่าต่อไปนี้เป็นไปได้สําหรับ properties.orchestration เขตข้อมูล
| มูลค่า | คำอธิบาย |
|---|---|
Classic |
ตัวแทนใช้การจัดการตามหัวข้อแบบคลาสสิกกับโครงสร้างการสนทนาที่เขียน |
Generative |
ตัวแทนใช้การจัดกลุ่มที่สร้าง โดยที่แบบจําลอง AI จะเลือกหัวข้อและการดําเนินการแบบไดนามิก |
โหมดการรับรองความถูกต้อง
ค่าต่อไปนี้เป็นไปได้สําหรับ properties.authentication เขตข้อมูล
| มูลค่า | คำอธิบาย |
|---|---|
None |
ไม่จําเป็นต้องรับรองความถูกต้อง |
Microsoft Entra |
รับรองความถูกต้องผ่าน Microsoft Entra ID |
Generic OAuth 2.0 |
การรับรองความถูกต้องผ่านผู้ให้บริการ OAuth 2.0 ทั่วไป |
ข้อจำกัดที่ทราบ
- เจ้าหน้าที่ V1 ไม่ได้รับการติดตาม เอเยนต์ (ตัวแทน) ที่สร้างขึ้นด้วยสภาพแวดล้อมการทำงานของ Power Virtual Agents V1 จะไม่ถูกรวมอยู่ในสินค้าคงคลัง ติดตามเฉพาะตัวแทน V2 (Copilot Studio) เท่านั้น
- คุณสมบัติของข้อมูลประจําตัวอาจไม่พร้อมใช้งานสําหรับตัวแทนทั้งหมด เขตข้อมูล
entraAgentIdและentraAgentBlueprintIdจะถูกสร้างขึ้นสําหรับตัวแทนที่ได้รับการจัดเตรียมด้วยแบบจําลองข้อมูลประจําตัวของตัวแทน Entra ที่ใหม่กว่าเท่านั้น ตัวแทนที่เก่ากว่าอาจมีเพียงentraAppId, และตัวแทน Microsoft 365 Copilot Agent Builder ไม่มีคุณสมบัติข้อมูลประจําตัวเหล่านี้