Bagikan melalui

Mengintegrasikan aplikasi web atau asli dengan Microsoft 365 Agents SDK

Penting

Konten ini ditujukan untuk profesional TI berpengalaman, seperti admin TI atau pengembang, yang terbiasa dengan alat pengembang, utilitas, dan lingkungan pengembangan terintegrasi (IDEs). Ini membutuhkan keahlian pengembangan perangkat lunak.

Setelah Anda membuat dan menguji agen di Copilot Studio, sebarkan ke saluran pilihan Anda untuk menguji bagaimana pengguna target Anda akan berinteraksi dengannya.

Nota

Jika Anda ingin menggunakan kode Semat untuk aplikasi web di Copilot Studio, Anda harus mengatur opsi autentikasi keamanan ke Tanpa autentikasi. Navigasi ke Pengaturan>AutentikasiKeamanan> dan pilih Tidak ada autentikasi untuk membuatnya tersedia untuk umum.

Panduan ini mencakup cara mengambil agen Copilot Studio Anda dan mengintegrasikannya dengan aplikasi web yang ada (biasanya situs web) atau aplikasi asli menggunakan klien Copilot Studio dengan Microsoft 365 Agents SDK.

Bagian yang berbeda dari panduan ini relevan tergantung pada apakah Anda memiliki UX/UI yang sudah ada yang ingin Anda integrasikan agennya, atau jika Anda berencana menggunakan UX/UI yang disediakan Microsoft. Gunakan tabel berikut untuk menemukan bagian yang sesuai dengan skenario Anda.

Metode Penyebaran Bagaimana, di mana, dan mengapa Tautan Cepat
Gunakan Kode Semat Obrolan Web Default Dengan agen yang memiliki pengaturan keamanan Tanpa Autentikasi diaktifkan, ini tersedia di panel publikasi saluran Web di Copilot Studio. Catatan: Opsi ini hanya muncul saat Anda tidak memiliki Autentikasi yang dipilih di Copilot Studio. Gunakan kode Web Chat Embed default (tanpa pengembangan/kode)
Menyambungkan ke Copilot Studio dengan rincian Masuk Pengguna SDK Agen Gunakan string koneksi SDK Agen atau pengaturan konfigurasi untuk berintegrasi langsung dengan agen Anda menggunakan kredensial pengguna dengan bantuan copilot. Mengonfigurasi pendaftaran aplikasi Anda untuk masuk interaktif pengguna
Menyambungkan ke Copilot Studio dengan rincian Masuk Prinsipal Layanan SDK Untuk digunakan di mana Anda ingin agen memiliki identitasnya sendiri dan tidak digunakan atas nama pengguna yang mengakses agen. Berguna dalam skenario di mana Anda tidak memerlukan konteks pengguna tetapi Anda masih perlu mengakses API atau informasi istimewa dan memerlukan autentikasi. Catatan: Untuk melakukan tugas ini, Anda harus memiliki autentikasi untuk agen ini di Copilot Studio yang diatur ke Tanpa Autentikasi. Konfigurasikan pendaftaran aplikasi Anda untuk Prinsipal Layanan
Menggunakan DirectLine versi lama untuk menyambungkan ke Copilot Studio Anda dapat terhubung ke DirectLine menggunakan DirectLine API dan harus digunakan di mana SDK Agen tidak mendukung skenario Anda. Memublikasikan agen ke aplikasi seluler atau kustom

Prasyarat

  • .NET Core / JS/ Python
  • Paket–Klien Copilot Studio
  • Agen

Metode untuk Mengintegrasikan agen Copilot Studio Anda

  • Klien Copilot Studio (menggunakan Agents SDK): Metode ini adalah cara yang disukai untuk berintegrasi dengan Copilot Studio.

  • DirectLine: DirectLine adalah cara warisan untuk berintegrasi dengan Copilot Studio dan harus digunakan di mana tidak ada dukungan untuk kasus penggunaan Anda dengan klien Copilot Studio.

    • Tidak mendukung token service principal

Memulai: Pengujian konfigurasi dasar dan koneksi agen menggunakan SDK Agen Microsoft 365

  1. Unduh Sampel klien Copilot Studio dari Microsoft 365 Agents SDK.

    Kami menyederhanakan integrasi dengan Agen SDK untuk aplikasi web dan asli Anda dengan menyediakan pustaka klien yang memungkinkan pengembang memasukkan beberapa detail tentang agen Anda dan untuk dengan mudah mengintegrasikannya ke dalam aplikasi Anda.

  2. Dapatkan sampel klien Copilot Studio dari repositori GitHub Agents SDK di C#, JavaScript atau Python.

  3. Dapatkan kode semat atau string koneksi untuk agen Anda di Copilot Studio.

    Anda memerlukan akses ke agen Anda di Copilot Studio untuk mendapatkan detail string koneksi (atau detail untuk pengaturan konfigurasi) agar dapat tersambung ke agen tersebut.

    Di Copilot Studio, buka agen Anda, pilih Pengaturan>AutentikasiKeamanan>, lalu tinjau pengaturan agen Anda.

    • Jika Autentikasi dengan Microsoft atau Autentikasi secara manual dipilih, Anda hanya melihat opsi string koneksi untuk diintegrasikan dengan Agen SDK.

    • Jika Tidak ada autentikasi yang dipilih, Anda akan melihat kode Semat yang dapat Anda tambahkan ke situs web dan string koneksi. Opsi Sematkan kode tidak menggunakan SDK Agen dan menggunakan komponen Web Chat siap pakai standar.

    Cuplikan layar pengaturan autentikasi agen, memperlihatkan tidak ada autentikasi yang dipilih.

  4. Dapatkan String sambungan Anda.

    Untuk mendapatkan string koneksi untuk agen Anda di Copilot Studio, pilih Aplikasi web atau aplikasi asli di halaman Saluran . Pilih Salin di samping string koneksi di bawah Microsoft 365 Agents SDK. Gunakan string ini untuk menyambungkan ke agen ini dari kode web atau aplikasi asli Anda.

    Cuplikan layar halaman Saluran Copilot Studio.

    Cuplikan layar panel saluran aplikasi Web di Copilot Studio.

  5. Dapatkan informasi untuk pengaturan konfigurasi tradisional.

    Jika Anda tidak ingin menggunakan metode string koneksi , dan sebagai gantinya menggunakan pengaturan konfigurasi tradisional, Anda memerlukan beberapa metadata lain dari agen Copilot Studio Anda.

    Pilih Pengaturan>Tingkat Lanjut. Di bawah Metadata, Anda memerlukan ID Lingkungan, ID Penyewa, dan Nama skema. Rekam nilai metadata ini untuk nanti.

    Cuplikan layar halaman pengaturan tingkat lanjut untuk agen di Copilot Studio.

  6. Konfigurasikan pendaftaran aplikasi Anda untuk izin yang benar untuk mengakses Copilot Studio.

    Web atau aplikasi asli Anda harus memiliki pendaftaran aplikasi di Azure. Jika Anda tidak memiliki pendaftaran aplikasi di Azure, Anda dapat mengikuti panduan lengkap tentang menyiapkannya menggunakan Readme atau di dokumentasi Azure. Untuk informasi selengkapnya, lihat Mendaftarkan aplikasi di ID Microsoft Entra.

    Nota

    Kemungkinan besar Anda sudah memiliki pendaftaran aplikasi yang ada untuk pendaftaran Anda, dan Anda perlu menggunakannya sebagai gantinya. Anda dapat mengonfigurasi metode autentikasi Pengguna atau Perwakilan Layanan untuk mengakses agen Anda.

Mengonfigurasi pendaftaran aplikasi Anda untuk masuk interaktif pengguna

  1. Navigasi ke izin> APITambahkan izin, pilih API yang digunakan organisasi saya, dan cari Power Platform API.

  2. Pilih izin yang didelegasikan>Copilot Studio>Copilot Studio.Copilots.Invoke. Pilih Tambahkan Izin.

Untuk login pengguna, Anda dapat menguji kerja sampel dengan mendaftarkan aplikasi dan agen Copilot Studio Anda melalui langkah-langkah berikut:

Menambahkan string koneksi ke pengaturan klien Copilot Studio di file appsettings.config :

  • DirectConnectUrl
  • TenantID:
  • ClientID:
  • ClientSecret:

Menambahkan pengaturan klien Copilot Studio dalam file appsettings.config :

  • EnvironmentID:
  • SchemaName:
  • TenantID:
  • AppClientID:
  • AppClientSecret:

Anda sekarang dapat menjalankan sampel dan terhubung ke agen melalui pengaturan pendaftaran aplikasi Anda menggunakan aplikasi konsol sampel.

Konfigurasikan pendaftaran aplikasi Anda untuk Prinsipal Layanan

Atau, Anda dapat memilih untuk mengonfigurasi pendaftaran aplikasi untuk autentikasi layanan daripada untuk autentikasi pengguna.

  1. Pada pendaftaran aplikasi Anda, buka izin API, tambahkan izin, pilih API yang digunakan organisasi saya, dan cari Power Platform API.
  2. Pilih Izin> aplikasiCopilot Studio, dan periksa izin Copilot Studio.Copilots.Invoke.
  3. Pilih Tambahkan Izin.

Untuk masuk pengguna, Anda dapat menguji contoh kerja menggunakan pendaftaran aplikasi dan agen Copilot Studio Anda, dengan:

  1. Menambahkan String Koneksi ke pengaturan klien Copilot Studio di file appsettings.config :

    • DirectConnectUrl
    • TenantID:
    • UseS2SConnection: true
    • ClientID:
    • ClientSecret:

  2. Menambahkan pengaturan klien Copilot Studio dalam file appsettings.config :

    • EnvironmentID:
    • SchemaName:
    • TenantID:
    • UseS2SConnection: true
    • AppClientID:
    • AppClientSecret:

Anda sekarang dapat menjalankan sampel dan terhubung ke agen dengan pengaturan pendaftaran aplikasi Anda menggunakan aplikasi konsol sampel.

Mengintegrasikan klien Copilot Studio ke UI/UX yang ada

Sekarang Anda telah menguji agen Anda dengan klien Copilot Studio. Pengujian mengonfirmasi bahwa agen Anda terhubung dengan aplikasi konsol sampel, Anda siap untuk mengintegrasikan pustaka ke situs web atau aplikasi yang ada, dan menghubungkan/memunculkannya dengan UI yang ada.

Bagaimana Anda mengintegrasikan agen Anda ke dalam aplikasi terserah Anda dan basis kode yang ada. Biasanya, langkah-langkah untuk mengintegrasikan agen Anda mungkin meliputi:

  1. Mereferensikan pustaka di aplikasi Anda.
  2. Menerapkan objek dan metode dari pustaka klien di proyek Anda.
  3. Menyuntikkan dengan DI atau mengelola klien berdasarkan desain aplikasi yang ada, memastikan Anda mereferensikan pengaturan aplikasi untuk detail konfigurasi untuk agen.

Gunakan kode Web Chat Embed default (tanpa pengembangan/kode)

Anda dapat menambahkan agen Copilot Studio ke situs web Anda menggunakan iFrame, yang dapat disematkan di HTML situs web/aplikasi web.

Kode ini hanya terlihat jika opsi Tidak ada autentikasi yang dipilih di pengaturan agen di Copilot Studio di bawah Keamanan. Jika Autentikasi dengan Microsoft atau Autentikasi secara manual dipilih, kode semat tidak terlihat.

Cuplikan layar pengaturan autentikasi agen.

Menggunakan DirectLine untuk menyambungkan ke Copilot Studio

Lihat Menerbitkan agen ke aplikasi seluler atau kustom untuk menggunakan DirectLine untuk berintegrasi dengan agen Copilot Studio Anda.