Inventaris agen Microsoft Copilot Studio

Inventaris agen Copilot Studio memberikan tampilan terpusat kepada admin TI dan keamanan atas semua agen yang dibuat menggunakan Copilot Studio atau Agent Builder di tenant. Inventaris mencakup baik agen yang belum dipublikasikan (draf) maupun agen yang dipublikasikan. Untuk setiap agen, inventori menampilkan metadata kunci, seperti siapa yang membuat agen, ketika terakhir diterbitkan, saluran apa yang disebarkannya, caranya mengautentikasi pengguna, kemampuannya, dan banyak lagi. Data inventori disegarkan secara otomatis, dan perubahan pada agen biasanya muncul dalam waktu 20 menit.

Administrator dapat menggunakan data inventori melalui beberapa metode, termasuk pusat admin Power Platform, API Power Platform, dan Azure Resource Graph. Untuk daftar lengkap metode akses dan peran yang diperlukan, lihat Inventarit Power Platform.

Artikel ini menjelaskan bidang khusus untuk agen Copilot Studio (microsoft.copilotstudio/agents) di inventarit Power Platform. Untuk bidang bersama yang tersedia di semua jenis sumber daya, lihat Referensi skema inventori Power Platform.

Note

Inventaris tidak mencakup agen yang dibuat dengan versi V1 dari Copilot Studio (juga dikenal sebagai bot klasik atau Power Virtual Agents). Namun, Anda masih dapat buka Pusat admin Power Platform dan memilih Kelola>Copilot Studio>Chatbot klasik untuk melihat agen tersebut.

Important

Artikel ini berisi dokumentasi pratinjau Microsoft Copilot Studio dan dapat berubah.

Fitur pratinjau tidak dimaksudkan untuk penggunaan produksi dan mungkin memiliki fungsionalitas terbatas. Fitur ini tersedia sebelum rilis resmi agar Anda bisa memperoleh akses awal dan memberikan tanggapan.

Jika Anda membangun agen yang siap untuk produksi, silakan lihat Gambaran Umum Microsoft Copilot Studio.

Properti agen

Inventori menyediakan properti berikut untuk setiap agen.

Note

Inventori mencerminkan struktur versi yang diterbitkan dari setiap agen. Jika agen memiliki perubahan yang belum dipublikasikan (draf yang lebih baru), inventori tidak menampilkan perubahan tersebut sampai agen tersebut dipublikasikan.
Konfigurasi agen memengaruhi kolom mana yang akan terisi. Beberapa properti mungkin null bergantung pada konfigurasi agen. Misalnya, isManaged adalah null untuk agen yang dibuat di Agent Builder.

Properti inti

Jalur bidang API	Jenis data	Description	Example	Status
`properties.displayName`	string	Nama tampilan agen.	`Customer support agent`	Tersedia secara umum
`properties.name`	GUID	ID agen di lingkungan Dataverse tertentu (ID bot CDS).	`aaaa0000-bb11-2222-33cc-444444dddddd`	Tersedia secara umum
`properties.createdAt`	tanggalwaktu	Tanggal dan waktu agen dibuat.	`2024-12-13T04:00:00Z`	Tersedia secara umum
`properties.createdBy`	GUID	Entra ID pengguna yang membuat agen.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Tersedia secara umum
`properties.ownerId`	string	ID objek (Entra ID) dari pemilik agen saat ini.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Tersedia secara umum
`properties.environmentId`	string	Pengidentifikasi lingkungan Power Platform yang berisi sumber daya.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Tersedia secara umum
`properties.lastPublishedAt`	tanggalwaktu	Tanggal dan waktu agen terakhir dipublikasikan. Kosong/null jika agen masih dalam draf.	`2026-01-15T10:30:00Z`	Tersedia secara umum
`properties.createdIn`	string	Alat penulisan tempat agen dibuat: Copilot Studio atau Microsoft 365 Copilot Agent Builder.	`Copilot Studio`	Tersedia secara umum
`properties.schemaName`	string	Nama skema Dataverse. Tersedia untuk agen Copilot Studio dan agen Microsoft 365 Copilot Agent Builder.	`cr5e3_agentName`	Tersedia secara umum
`properties.isQuarantined`	boolean	Apakah agen saat ini dikarantina.	`false`	Tinjauan
`properties.quarantinedAt`	tanggalwaktu	Tanggal dan waktu agen terakhir dikarantina.	`2026-02-01T08:00:00Z`	Tinjauan
`properties.isManaged`	boolean	Apakah agen adalah bagian dari solusi Dataverse terkelola. Null untuk agen yang dibuat di Agent Builder.	`false`	Tinjauan

Properti identitas Entra

Jalur bidang API	Jenis data	Description	Example	Status
`properties.botId`	string	ID bot CDS di lingkungan.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Tersedia secara umum
`properties.entraAppId`	string	ID Pendaftaran Aplikasi Entra yang terkait dengan agen, jika ada.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Tersedia secara umum
`properties.entraAgentId`	string	ID Agen Entra, jika ada.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Tersedia secara umum
`properties.entraAgentBlueprintId`	string	ID Blueprint Agen Entra, jika ada.	`aaaa0000-bb11-2222-33cc-444444dddddd`	Tersedia secara umum

Note

Tidak semua properti identitas tersedia untuk semua jenis agen: entraAppId adalah pengidentifikasi lama, agen yang lebih baru menggunakan entraAgentId dan entraAgentBlueprintId. Bidang ini hanya diisi jika berlaku untuk agen tertentu. Tidak satu pun dari properti identitas ini berlaku untuk agen Microsoft 365 Copilot Agent Builder.

Pelajari lebih lanjut tentang Identitas agen dan autentikasi di Copilot Studio.

Pengaturan konfigurasi

Jalur bidang API	Jenis data	Description	Example	Status
`properties.orchestration`	string	Mode orkestrasi agen (pelajari lebih lanjut dalam mode Orkestrasi).	`Generative`	Tinjauan
`properties.model`	string	Model AI yang digunakan oleh agen.	`gpt-4o`	Tinjauan
`properties.authentication`	string	Mode autentikasi yang dikonfigurasi untuk agen (pelajari selengkapnya dalam mode Autentikasi).	`Microsoft Entra`	Tinjauan
`properties.channels`	array	Nama tampilan saluran tempat agen dipublikasikan.	`["Teams","SharePoint"]`	Tinjauan
`properties.sharedWithViewers`	objek	Jumlah pengguna penampil individu (`userCount`) dan grup penampil (`groupCount`) yang dibagikan agen. Jika pembuat membagikan agen dengan seluruh penyewa, `entireTenant` diatur ke `true`, bahkan jika admin tidak menyetujui pembagian tersebut.	`"groupCount": 0, "userCount": 0, "entireTenant": false`	Tinjauan
`properties.sharedWithEditors`	objek	Jumlah pengguna editor individu (`userCount`) dan grup editor (`groupCount`) yang dibagikan agen.	`"groupCount": 0, "userCount": 0`	Tinjauan
`properties.capabilitiesCounts`	objek	Jumlah unik total untuk setiap jenis kemampuan yang dikonfigurasi	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Tinjauan

Mode orkestrasi

Bidang properties.orchestration menerima nilai berikut:

Nilai	Description
Classic	Agen menggunakan orkestrasi berbasis topik klasik dengan pohon dialog yang ditulis.
Generatif	Agen menggunakan orkestrasi generatif, dengan model AI secara dinamis memilih topik dan alat.

Modus autentikasi

Bidang properties.authentication menerima nilai berikut:

Nilai	Description
Tidak	Tidak diperlukan autentikasi.
Microsoft Entra	Autentikasi melalui ID Microsoft Entra.
OAuth Umum 2.0	Autentikasi melalui penyedia OAuth 2.0 generik.

Kemampuan agen

Bagian ini mencantumkan kemampuan (alat dan pengetahuan) agen. Saat ini, ini hanya menampilkan data terperinci tentang konektor yang digunakan oleh agen dan konfigurasi pengetahuan sebagaimana dirinci di bagian berikut.

Inventori memiliki batasan maksimum 200 sumber daya dari setiap jenis per agen. Pelajari selengkapnya di Batasan yang diketahui.

Inventori secara otomatis menghapus sumber daya duplikat, seperti konektor Power Platform yang Anda konfigurasikan dua kali di agen dengan konfigurasi yang sama.

Properti konektor

Inventaris mencakup larik yang disebut powerPlatformConnectors, yang berisi konektor Power Platform yang dikonfigurasi dalam agen. Setiap konektor diidentifikasi oleh ( connectorId string yang berisi ID sumber daya konektor; misalnya, shared_excelonlinebusiness). Untuk setiap konektor yang dikonfigurasi, ada daftar operations yang dikonfigurasi. Daftar ini mencakup properti berikut:

Property	Jenis data	Description	Status
`OperationId`	string	ID operasi tertentu dalam konektor; misalnya, `AddRowV2`	Tinjauan
`createdBy`	GUID	Pengguna yang mengonfigurasi operasi	Tinjauan
`isEnabled`	boolean	Apakah operasi konektor saat ini diaktifkan	Tinjauan
`usedAs`	string	Cara operasi digunakan: `Tool` jika dikonfigurasi sebagai alat umum `Topic Tool` jika dikonfigurasi sebagai alat dalam topik tertentu `Knowledge` jika konektor dikonfigurasi sebagai sumber pengetahuan	Tinjauan
`requiresEndUserConsent`	boolean	Apakah pengguna akhir harus menyetujui sebelum agen dapat menggunakan operasi	Tinjauan
`whenCanBeUsed`	string	Kapan operasi dapat dipanggil: `Anytime` jika alat tersedia untuk agen tanpa batasan `ViaDirectReferenceOnly` jika agen menggunakan alat hanya ketika pembuat secara eksplisit mengonfigurasinya dalam topik tertentu `Conditional` jika agen dapat menggunakan alat sesuai dengan logika yang telah ditentukan sebelumnya oleh pembuat	Tinjauan
`connectionProvider`	string	Siapa yang menyediakan koneksi untuk operasi: `User` jika pengguna akhir menyediakan kredensial dalam runtime `Maker` jika pembuat mengatur koneksi pada waktu penulisan	Tinjauan
`connectionIdSharedByMaker`	GUID	ID koneksi, diisi hanya ketika `connectionProvider = Maker`	Tinjauan

Example

{
  "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
    }
  }
}

Atribut pengetahuan

Inventori mencakup properti berikut untuk pengetahuan:

Property	Jenis data	Description	Status
`IsWebSearchEnabledForKnowledge`	boolean	Benar jika agen dapat menggunakan pencarian web sebagai sumber pengetahuan	Tinjauan

Batasan yang diketahui

Agen V1 tidak dilacak - Inventaris tidak menyertakan agen yang dibuat dengan runtime Power Virtual Agents V1 asli. Ini hanya melacak agen V2 (Copilot Studio).
Properti identitas mungkin tidak tersedia untuk semua agen - Bidang entraAgentId dan entraAgentBlueprintId hanya diisi untuk agen yang disediakan dengan model ID Agen Entra yang lebih baru. Agen lama mungkin hanya memiliki entraAppId, dan agen Microsoft 365 Copilot Agent Builder tidak memiliki salah satu properti identitas ini.
Jumlah kemampuan - Inventori memiliki batasan maksimum 200 sumber daya dari setiap jenis per agen. Jika agen memiliki lebih dari 200 sumber daya yang dikonfigurasi dari jenis tertentu (misalnya, konektor Power Platform), inventori akan menampilkan 200 acak. Admin dapat menggunakan capabilitiesCounts bidang untuk memahami berapa banyak sumber daya yang dikonfigurasi dalam agen per jenis.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-08-27

Inventaris agen Microsoft Copilot Studio

Properti agen

Properti inti

Properti identitas Entra

Pengaturan konfigurasi

Mode orkestrasi

Modus autentikasi

Kemampuan agen

Properti konektor

Example

Atribut pengetahuan

Batasan yang diketahui

Konten terkait

Saran dan Komentar

Sumber Daya Tambahan: