Inventaris Microsoft Copilot Studio Agent

Inventaris agen Copilot Studio memberi admin TI dan keamanan pandangan terpusat atas semua agen yang dibuat menggunakan Copilot Studio atau Agent Builder dalam penyewa. Inventaris mencakup agen yang belum diterbitkan (draf) dan yang sudah diterbitkan. Untuk setiap agen, inventaris menampilkan metadata utama, seperti siapa yang membuat agen, kapan terakhir kali diterbitkan, saluran tempat agen disebarkan, metode autentikasi pengguna, kemampuannya, dan lainnya. Data inventaris diperbarui secara otomatis, dan perubahan pada agen biasanya muncul dalam waktu 20 menit.

Administrator dapat mengakses data inventaris 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 inventaris Power Platform.

Artikel ini menjelaskan bidang-bidang yang spesifik untuk agen Copilot Studio (microsoft.copilotstudio/agents) dalam inventaris Power Platform. Untuk bidang bersama yang tersedia pada semua jenis sumber daya, lihat Referensi skema inventaris Power Platform.

Catatan

Inventaris tidak mencakup agen yang dibuat dengan V1 dari Copilot Studio (juga dikenal sebagai bot klasik atau Power Virtual Agents). Namun, Anda tetap dapat membuka pusat admin Power Platform dan memilih Kelola>Copilot Studio>Bot obrolan klasik untuk melihat agen tersebut.

Penting

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

Fitur pratinjau tidak dibuat 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 siap produksi, lihat Gambaran umum Microsoft Copilot Studio.

Properti agen

Inventaris menyediakan properti berikut untuk setiap agen.

Catatan

Inventaris mencerminkan struktur dari versi yang diterbitkan dari setiap agen. Jika agen memiliki perubahan yang belum diterbitkan (draf yang lebih baru), inventaris tidak menampilkan perubahan tersebut hingga agen diterbitkan.
Konfigurasi agen memengaruhi bidang yang diisi. Beberapa properti mungkin null bergantung pada bagaimana agen disiapkan. Misalnya, isManaged adalah null untuk agen yang dibuat di Agent Builder.

Properti inti

Jalur bidang API	Tipe data	Deskripsi	Contoh	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`	datetime	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`	datetime	Tanggal dan waktu agen terakhir dipublikasikan. Kosong/null jika agen masih dalam draf.	`2026-01-15T10:30:00Z`	Tersedia secara umum
`properties.createdIn`	string	Perangkat 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`	Pratinjau
`properties.quarantinedAt`	datetime	Tanggal dan waktu agen terakhir dikarantina.	`2026-02-01T08:00:00Z`	Pratinjau
`properties.isManaged`	boolean	Apakah agen merupakan bagian dari solusi Dataverse terkelola. Null untuk agen yang dibuat di Agent Builder.	`false`	Pratinjau

Properti identitas Entra

Jalur bidang API	Tipe data	Deskripsi	Contoh	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 Identitas 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

Catatan

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. Tak satu pun dari properti identitas ini berlaku untuk agen Microsoft 365 Copilot Agent Builder.

Untuk informasi lebih lanjut tentang konsep identitas Entra, baca Pendaftaran aplikasi, identitas agen, dan autentikasi untuk Copilot Studio.

Properti konfigurasi

Jalur bidang API	Tipe data	Deskripsi	Contoh	Status
`properties.orchestration`	string	Mode orkestrasi agen (pelajari lebih lanjut di Mode Orkestrasi).	`Generative`	Pratinjau
`properties.model`	string	Model AI yang digunakan oleh agen.	`gpt-4o`	Pratinjau
`properties.authentication`	string	Mode autentikasi yang dikonfigurasi untuk agen (pelajari lebih lanjut di Mode Autentikasi).	`Microsoft Entra`	Pratinjau
`properties.channels`	larik	Nama tampilan saluran tempat agen dipublikasikan.	`["Teams","SharePoint"]`	Pratinjau
`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`	Pratinjau
`properties.sharedWithEditors`	objek	Jumlah pengguna editor individu (`userCount`) dan grup editor (`groupCount`) yang dibagikan agen.	`"groupCount": 0, "userCount": 0`	Pratinjau
`properties.capabilitiesCounts`	objek	Total jumlah berbeda dari setiap jenis kemampuan yang dikonfigurasi	`"distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0`	Pratinjau

Mode orkestrasi

Bidang properties.orchestration menerima nilai berikut:

Nilai	Deskripsi
Klasik	Agen ini menggunakan orkestrasi berbasis topik klasik dengan pohon dialog yang telah dibuat.
Generatif	Agen menggunakan orkestrasi generatif, dengan model AI secara dinamis memilih topik dan tindakan.

Mode autentikasi

Bidang properties.authentication menerima nilai berikut:

Nilai	Deskripsi
Tidak ada	Tidak diperlukan autentikasi.
Microsoft Entra	Autentikasi melalui Microsoft Entra ID.
OAuth 2.0 Generik	Autentikasi melalui penyedia OAuth 2.0 generik.

Kemampuan agen

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

Inventaris memiliki batasan maksimum 200 sumber daya dari setiap jenis per agen. Pelajari lebih lanjut di Batasan yang diketahui.

Inventaris secara otomatis menghapus sumber daya duplikat, seperti konektor Power Platform yang Anda konfigurasikan dua kali dalam 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 (sebuah string yang berisi ID sumber daya konektor; misalnya, shared_excelonlinebusiness). Untuk setiap konektor yang dikonfigurasi, ada daftar operations yang dikonfigurasi. Daftar mencakup properti berikut:

Properti	Tipe data	Deskripsi	Status
`OperationId`	string	ID dari operasi spesifik pada konektor; misalnya, `AddRowV2`	Pratinjau
`createdBy`	GUID	Pengguna yang mengonfigurasi operasi	Pratinjau
`isEnabled`	boolean	Apakah operasi konektor saat ini diaktifkan	Pratinjau
`usedAs`	string	Bagaimana operasi digunakan: `Tool` jika dikonfigurasi sebagai alat umum `Topic Tool` jika dikonfigurasi sebagai alat dalam topik tertentu `Knowledge` jika konektor dikonfigurasi sebagai sumber pengetahuan	Pratinjau
`requiresEndUserConsent`	boolean	Apakah pengguna akhir harus menyetujui sebelum agen dapat menggunakan operasi	Pratinjau
`whenCanBeUsed`	string	Saat operasi dapat dipanggil: `Anytime` jika alat tersedia untuk agen tanpa batasan `ViaDirectReferenceOnly` jika agen menggunakan alat hanya ketika pembuat secara eksplisit mengonfigurasikan alat tersebut dalam topik tertentu `Conditional` jika agen dapat menggunakan alat sesuai logika yang telah ditentukan oleh pembuat	Pratinjau
`connectionProvider`	string	Siapa yang menyediakan koneksi untuk operasi: `User` jika pengguna akhir memberikan kredensial saat runtime `Maker` jika pembuat mengatur koneksi saat penulisan	Pratinjau
`connectionIdSharedByMaker`	GUID	ID koneksi, hanya diisi saat `connectionProvider = Maker`	Pratinjau

Contoh

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

Properti pengetahuan

Inventaris mencakup properti berikut untuk pengetahuan:

Properti	Tipe data	Deskripsi	Status
`IsWebSearchEnabledForKnowledge`	boolean	Benar jika agen dapat menggunakan penelusuran web sebagai sumber pengetahuan	Pratinjau

Pembatasan yang diketahui

Agen V1 tidak dilacak - Inventaris tidak menyertakan agen yang dibuat dengan runtime Power Virtual Agents V1 asli. Inventaris 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 identitas agen Entra yang lebih baru. Agen yang lebih lama mungkin hanya memiliki entraAppId, dan agen Microsoft 365 Copilot Agent Builder tidak memiliki salah satu dari properti identitas ini.
Jumlah kemampuan - Inventaris memiliki batas 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), inventaris menampilkan 200 yang dipilih secara acak. Admin dapat menggunakan bidang capabilitiesCounts untuk memahami berapa banyak sumber daya yang dikonfigurasi dalam agen per jenis.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-07-31

Inventaris Microsoft Copilot Studio Agent

Properti agen

Properti inti

Properti identitas Entra

Properti konfigurasi

Mode orkestrasi

Mode autentikasi

Kemampuan agen

Properti konektor

Contoh

Properti pengetahuan

Pembatasan yang diketahui

Konten terkait

Saran dan Komentar

Sumber Daya Tambahan: