Membuat alur kerja agen percakapan dengan interaksi obrolan di Azure Logic Apps

Berlaku untuk: Azure Logic Apps (Consumption + Standard)

Saat Anda memerlukan otomatisasi bertenaga AI yang berinteraksi dengan manusia, buat alur kerja agen percakapan di Azure Logic Apps. Alur kerja ini menggunakan bahasa alami, perulangan agen, dan model bahasa besar (LLM) untuk membuat keputusan dan menyelesaikan tugas berdasarkan input dan pertanyaan yang disediakan manusia, yang dikenal sebagai perintah. Alur kerja ini berfungsi paling baik untuk otomatisasi yang berbasis pengguna, berumur pendek, atau berbasis sesi.

Contoh alur kerja berikut menggunakan agen percakapan untuk mendapatkan cuaca saat ini dan mengirim pemberitahuan email:

Panduan ini memperlihatkan cara membuat aplikasi logika Konsumsi atau Standar menggunakan jenis alur kerja Agen Percakapan . Alur kerja ini berjalan menggunakan perintah dan alat yang disediakan manusia yang Anda buat untuk menyelesaikan tugas. Untuk gambaran umum tingkat tinggi tentang alur kerja agen, lihat Alur kerja agen AI di Azure Logic Apps.

Penting

Alur kerja agen percakapan konsumsi sedang dalam pratinjau dan tunduk pada Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

Prasyarat

• Akun dan langganan Azure. Dapatkan akun Azure gratis.

Berdasarkan apakah Anda ingin membuat aplikasi logika Konsumsi atau Standar, prasyarat berikut berlaku:

Konsumsi (pratinjau)

• Sumber daya aplikasi logika Konsumsi yang menggunakan jenis alur kerja bernama Agen Percakapan. Lihat Membuat alur kerja aplikasi logika Konsumsi di portal Microsoft Azure.

  Alur kerja agen percakapan konsumsi tidak mengharuskan Anda menyiapkan model AI terpisah secara manual. Alur kerja Anda secara otomatis menyertakan tindakan agen yang menggunakan model Layanan Azure OpenAI yang dihosting di Azure AI Foundry. Alur kerja agen hanya mendukung model tertentu. Lihat Model yang didukung.

  Nota

  Anda hanya dapat menggunakan portal Microsoft Azure untuk membangun alur kerja agen percakapan, bukan Visual Studio Code.

Untuk autentikasi dan otorisasi obrolan eksternal, alur kerja agen percakapan Konsumsi menggunakan OAuth 2.0 dengan ID Microsoft Entra.

Standar

• Akun dan langganan Azure. Dapatkan akun Azure gratis.

• Sumber daya atau proyek aplikasi logika Standar, berdasarkan pengalaman pengembangan Anda:

  Pengalaman	Persyaratan
  portal Azure	Sumber daya aplikasi logika Standar. Lihat Membuat alur kerja Standar di portal Microsoft Azure.
  Visual Studio Code	Proyek aplikasi logika Standar. Lihat Membuat alur kerja Standar di Visual Studio Code. Pastikan Anda memiliki ekstensi Azure Logic Apps terbaru.

  Nota

  Langkah-langkah untuk menyiapkan obrolan percakapan sebagian besar sama untuk portal Microsoft Azure dan Visual Studio Code. Contoh dalam panduan ini menunjukkan instruksi untuk setiap pengalaman di mana prosesnya berbeda.

• Salah satu sumber model AI berikut:

  Nota

  Alur kerja agen hanya mendukung model tertentu. Lihat Model yang didukung.

  Sumber model	Description
  Azure OpenAI	Sebuah sumber daya Azure OpenAI Service dengan model Azure OpenAI Service yang sudah disebarkan. Anda memerlukan nama sumber daya saat menyambungkan dari agen di alur kerja Anda ke model AI yang disebarkan di Azure OpenAI Service. Untuk informasi selengkapnya, lihat: - Membuat dan menyebarkan sumber daya Azure OpenAI Service - Mengimplementasikan model
  APIM Gen AI Gateway	Akun Azure API Management dengan LLM API yang akan digunakan. Untuk informasi selengkapnya, lihat: - Gerbang AI di Azure API Management - Mengimpor API dari Azure AI Foundry - Mengimpor API Azure OpenAI

• Autentikasi yang akan digunakan saat Anda menyambungkan agen ke model AI Anda.

  • Autentikasi identitas terkelola

    Koneksi ini mendukung autentikasi menggunakan ID Microsoft Entra dengan identitas terkelola. Dalam skenario produksi, Microsoft sangat menyarankan Agar Anda menggunakan identitas terkelola jika memungkinkan. Opsi ini memberikan keamanan yang optimal dan unggul tanpa biaya tambahan. Azure mengelola identitas ini untuk Anda, sehingga Anda tidak perlu memberikan atau mengelola informasi sensitif seperti kredensial atau rahasia. Informasi ini bahkan tidak dapat diakses oleh pengguna individual. Anda dapat menggunakan identitas terkelola untuk mengautentikasi akses untuk sumber daya apa pun yang mendukung autentikasi Microsoft Entra.

    Untuk menggunakan autentikasi identitas terkelola, sumber daya aplikasi logika Standar Anda harus mengaktifkan identitas terkelola yang ditetapkan sistem. Secara default, identitas terkelola yang ditetapkan sistem diaktifkan pada aplikasi logika Standar. Rilis ini saat ini tidak mendukung penggunaan identitas terkelola yang ditetapkan pengguna.

    Nota

    Jika identitas yang ditetapkan sistem dinonaktifkan, aktifkan kembali identitas.

    Identitas yang ditetapkan sistem memerlukan salah satu peran berikut untuk kontrol akses berbasis peran (RBAC) Microsoft Entra, berdasarkan prinsip hak istimewa paling sedikit:

    Sumber model	Role
    Sumber daya Layanan Azure OpenAI	- Pengguna OpenAI Cognitive Services (paling rendah hak akses) - Kontributor Cognitive Services OpenAI

    Untuk informasi selengkapnya tentang penyiapan identitas terkelola, lihat:

    • Mengautentikasi akses dan koneksi dengan identitas terkelola di Azure Logic Apps
    • Kontrol akses berbasis peran untuk Azure OpenAI Service
    • Praktik terbaik untuk peran Microsoft Entra

  • URL dan autentikasi berbasis kunci

    Koneksi ini mendukung autentikasi dengan menggunakan URL titik akhir dan kunci API untuk model AI Anda. Namun, Anda tidak perlu menemukan nilai-nilai ini secara manual sebelum membuat koneksi. Nilai secara otomatis muncul saat Anda memilih sumber model Anda.

    Penting

    Gunakan opsi autentikasi ini hanya untuk contoh dalam panduan ini, skenario eksplorasi, skenario nonproduksi, atau jika kebijakan organisasi Anda menentukan bahwa Anda tidak dapat menggunakan autentikasi identitas terkelola.

    Secara umum, pastikan Anda mengamankan dan melindungi data sensitif dan data pribadi, seperti kredensial, rahasia, kunci akses, string koneksi, sertifikat, thumbprint, dan informasi serupa dengan tingkat keamanan tertinggi yang tersedia atau didukung. Jangan hardcode data sensitif, bagikan dengan pengguna lain, atau simpan dalam teks biasa di mana pun orang lain dapat mengakses. Siapkan rencana untuk mengganti atau mencabut rahasia jika rahasia tersebut dibobol.

    Untuk informasi selengkapnya, lihat:

    • Praktik terbaik untuk melindungi rahasia
    • Rahasia di Azure Key Vault
    • Mengotomatiskan rotasi rahasia di Azure Key Vault

• Untuk mengikuti contohnya, Anda memerlukan akun email untuk mengirim email.

  Contoh dalam panduan ini menggunakan akun Outlook.com. Untuk skenario Anda sendiri, Anda bisa menggunakan layanan email atau aplikasi olahpesan yang didukung di Azure Logic Apps, seperti Office 365 Outlook, Microsoft Teams, Slack, dan sebagainya. Penyiapan untuk layanan atau aplikasi email lainnya mirip dengan contoh, tetapi memiliki perbedaan kecil.

Batasan dan masalah yang diketahui

Tabel berikut menjelaskan batasan saat ini dan masalah yang diketahui dalam rilis ini.

Aplikasi logika	Batasan atau masalah yang diketahui
Both	Untuk membuat alat untuk agen Anda, batasan berikut berlaku: - Anda hanya dapat menambahkan tindakan, bukan pemicu. - Alat harus dimulai dengan tindakan dan selalu berisi setidaknya satu tindakan. - Alat hanya berfungsi di dalam agen tempat alat itu ada. - Tindakan alur kontrol tidak didukung.
Konsumsi	- Anda hanya dapat membuat alur kerja agen Konsumsi di portal Microsoft Azure, bukan Visual Studio Code. - Model AI yang digunakan agen Anda dapat berasal dari wilayah mana pun, sehingga residensi data untuk wilayah tertentu tidak dijamin untuk data yang ditangani model. - Tindakan Agen dibatasi berdasarkan jumlah token yang digunakan.
Standar	- Jenis alur kerja yang tidak didukung: Stateless Untuk batas umum di Azure OpenAI Service dan Azure Logic Apps, lihat: - Kuota dan batas layanan Azure OpenAI - Batas dan konfigurasi Azure Logic Apps

Model Layanan Azure OpenAI yang didukung untuk alur kerja agen

Daftar berikut menentukan model AI yang bisa Anda gunakan dengan alur kerja agen:

Konsumsi (pratinjau)

Agen Anda secara otomatis menggunakan salah satu model Azure OpenAI Service berikut:

• gpt-4o-mini
• gpt-5o-mini

Penting

Model AI yang digunakan agen Anda dapat berasal dari wilayah mana pun, sehingga residensi data untuk wilayah tertentu tidak dijamin untuk data yang ditangani model.

Standar

Agen Anda dapat menggunakan salah satu model berikut:

• gpt-5
• gpt-4.1
• gpt-4.1-mini
• gpt-4.1-nano
• gpt-4o
• gpt-4o-mini
• gpt-4
• gpt-35-turbo

Billing

• Konsumsi: Penagihan menggunakan model bayar sesuai pemakaian. Harga siklus agen didasarkan pada jumlah token yang digunakan dalam setiap tindakan agen dan muncul sebagai Unit Enterprise pada tagihan Anda. Untuk informasi harga tertentu, lihat Harga Azure Logic Apps.

• Standar: Meskipun alur kerja agen tidak dikenakan biaya tambahan, penggunaan model AI dikenakan biaya. Untuk informasi selengkapnya, lihat Kalkulator Harga Azure.

Membuat alur kerja agen percakapan

Bagian berikut ini memperlihatkan cara mulai membuat alur kerja agen percakapan Anda.

Konsumsi (pratinjau)

Jenis alur kerja Agen Percakapan membuat alur kerja parsial yang dimulai dengan pemicu yang diperlukan bernama Saat sesi obrolan baru dimulai. Alur kerja juga menyertakan tindakan Agen Default kosong.

Untuk membuka alur kerja parsial ini, ikuti langkah-langkah berikut:

1. Di portal Azure, buka sumber daya aplikasi logika Konsumsi Anda.

2. Pada bilah sisi sumber daya, di bawah Alat Pengembangan, pilih perancang untuk membuka alur kerja agenik parsial.

   Perancang menunjukkan alur kerja parsial yang dimulai dengan pemicu yang diperlukan bernama Saat sesi obrolan baru dimulai. Di bawah pemicu, muncul tindakan Agen kosong bernama Agen Default. Untuk skenario ini, Anda tidak memerlukan penyiapan pemicu lainnya.

   

3. Lanjutkan ke bagian berikutnya untuk menyiapkan agen Anda.

Standar

Berdasarkan pengalaman pengembangan yang Anda gunakan, mulailah dengan membuat alur kerja baru.

Membuat alur kerja agen di portal Microsoft Azure

1. Di portal Azure, buka sumber daya aplikasi logika Standard Anda.

2. Pada bilah sisi sumber daya, di bawah Alur Kerja, pilih Alur Kerja.

3. Pada toolbar halaman Alur Kerja, pilih Buat>.

4. Pada panel Buat alur kerja , selesaikan langkah-langkah berikut ini:

   1. Untuk Nama alur kerja, berikan nama untuk digunakan alur kerja Anda.

   2. Pilih Agen Percakapan>Buat.

      

      Perancang membuka dan memperlihatkan alur kerja parsial yang dimulai dengan pemicu yang diperlukan bernama Saat sesi obrolan baru dimulai dan tindakan Agen kosong yang perlu Anda siapkan nanti.

      

   Sebelum dapat menyimpan alur kerja, Anda harus menyelesaikan tugas penyetelan berikut untuk tindakan Agen :

   • Sambungkan agen Anda ke model AI Anda. Anda menyelesaikan tugas ini di bagian selanjutnya.

   • Berikan instruksi agen yang menggunakan bahasa alami untuk menjelaskan peran yang dimainkan agen, tugas yang dapat dilakukan agen, dan informasi lain untuk membantu agen lebih memahami cara beroperasi. Anda juga menyelesaikan tugas ini di bagian selanjutnya.

5. Lanjutkan ke bagian berikutnya untuk menyiapkan agen Anda.

Membuat alur kerja agen di Visual Studio Code

1. Di Visual Studio Code, buka ruang kerja untuk proyek aplikasi logika Standar Anda.

2. Pada Bilah Aktivitas, pilih ikon file, yang membuka jendela Explorer untuk menampilkan proyek Anda.

3. Di jendela Explorer, dari menu pintasan folder proyek Anda, pilih Buat alur kerja.

4. Pilih templat alur kerja bernama Agen percakapan.

5. Berikan nama untuk alur kerja Anda, dan tekan Enter.

   Folder alur kerja baru sekarang muncul di proyek Anda. Folder ini berisi file workflow.json , yang berisi definisi JSON yang mendasar alur kerja.

6. Dari menu pintasan file workflow.json, pilih Buka Desainer.

   Perancang membuka dan memperlihatkan alur kerja parsial yang dimulai dengan pemicu yang diperlukan bernama Saat sesi obrolan baru dimulai dan tindakan Agen Default kosong yang perlu Anda siapkan nanti.

   

7. Lanjutkan ke bagian berikutnya untuk menyiapkan agen Anda.

Nota

Jika Anda mencoba menyimpan alur kerja sekarang, toolbar perancang menampilkan titik merah pada tombol Kesalahan . Perancang memperingatkan Anda untuk kondisi kesalahan ini karena agen memerlukan penyiapan sebelum Anda dapat menyimpan perubahan apa pun. Namun, Anda tidak perlu menyiapkan agen sekarang. Anda dapat terus membuat alur kerja Anda. Ingatlah untuk menyiapkan agen sebelum Anda menyimpan alur kerja Anda.

Menyiapkan atau melihat model AI

Untuk menyiapkan atau melihat model AI untuk agen Anda, ikuti langkah-langkah berdasarkan jenis aplikasi logika Anda:

Konsumsi (pratinjau)

Secara default, agen Anda secara otomatis menggunakan model Azure OpenAI yang tersedia di wilayah aplikasi logika Anda. Beberapa wilayah mendukung gpt-4o-mini, sementara yang lain mendukung gpt-5o-mini.

Untuk melihat model yang digunakan agen Anda, ikuti langkah-langkah berikut:

1. Pada desainer, pilih bilah judul pada tindakan Agen Default untuk menampilkan panel informasi.

2. Pada tab Parameter , parameter Id Model memperlihatkan model Azure OpenAI yang digunakan alur kerja, misalnya:

   

3. Lanjutkan ke bagian berikutnya untuk mengganti nama agen.

Standar

1. Pada perancang, pilih bilah judul pada tindakan Agen untuk membuka panel Buat koneksi .

   Panel ini terbuka hanya jika Anda tidak memiliki koneksi kerja yang sudah ada.

2. Di bagian Buat koneksi baru , berikan informasi berikut ini:

   Pengaturan	Diperlukan	Nilai	Description
   Nama Koneksi	Yes	< nama-koneksi>	Nama yang digunakan untuk koneksi ke model AI Anda. Contoh ini menggunakan fabrikam-azure-ai-connection.
   Sumber Model Agen	Yes	- Azure OpenAI - APIM Gen AI Gateway	Sumber untuk model AI di sumber daya Azure OpenAI Service atau LLM API Anda di akun Azure API Management Anda.
   Jenis Autentikasi	Yes	- Identitas terkelola - URL dan autentikasi berbasis kunci	Jenis autentikasi yang digunakan untuk memvalidasi dan mengotorisasi akses identitas ke model AI Anda. - Identitas terkelola mengharuskan aplikasi logika Standar Anda mengaktifkan identitas terkelola dan disiapkan dengan peran yang diperlukan untuk akses berbasis peran. Untuk informasi selengkapnya, lihat Prasyarat. - URL dan autentikasi berbasis kunci memerlukan URL titik akhir dan kunci API untuk model AI Anda. Nilai-nilai ini secara otomatis muncul saat Anda memilih sumber model Anda. Penting: Untuk contoh dan eksplorasi saja, Anda dapat menggunakan URL dan autentikasi berbasis kunci. Untuk skenario produksi, gunakan Identitas terkelola.
   Subscription	Yes	< Langganan Azure>	Pilih langganan Azure untuk sumber daya Azure OpenAI Service atau akun Azure API Management Anda.
   Sumber Daya Azure OpenAI	Ya, hanya ketika Sumber Model Agen adalah Azure OpenAI	< Azure-OpenAI-Service-resource-name>	Pilih sumber daya Azure OpenAI Service Anda.
   Azure API Management Service (pratinjau)	Ya, hanya ketika Sumber Model Agen adalah APIM Gen AI Gateway.	< API-Management-account>	Pilih akun Azure API Management Anda.
   API Layanan Azure API Management Service	Ya, hanya ketika Sumber Model Agen adalah APIM Gen AI Gateway.	< API-Management-LLM-API>	Pilih LLM API Anda di Azure API Management.
   Titik Akhir API	Yes	Diisi otomatis	URL titik akhir untuk model AI Anda di Azure OpenAI Service atau LLM API di Azure API Management. Contoh ini menggunakan https://fabrikam-azureopenai.openai.azure.com/.
   Kunci API	Ya, hanya ketika Jenis Autentikasi adalah URL dan autentikasi berbasis kunci	Diisi otomatis	Kunci API untuk model AI Anda di Azure OpenAI Service atau LLM API Anda di Azure API Management.

   Misalnya, jika Anda memilih Azure OpenAI sebagai sumber model dan Identitas terkelola untuk autentikasi, informasi koneksi Anda terlihat seperti sampel berikut:

   

3. Setelah selesai, pilih Buat baru.

   Jika Anda ingin membuat koneksi yang berbeda, pada tab Parameter , gulir ke bawah, dan pilih Ubah koneksi.

   Nota

   Jika koneksi ke model Anda salah, daftar Model AI tampak tidak tersedia.

4. Lanjutkan ke bagian berikutnya untuk mengganti nama agen.

Mengganti nama agen

Perbarui nama agen untuk mengidentifikasi tujuan agen dengan jelas dengan mengikuti langkah-langkah berikut:

1. Pada perancang, pilih bilah judul agen untuk membuka panel informasi agen.

2. Pada panel informasi, pilih nama agen, dan masukkan nama baru, misalnya, Weather agent.

   

3. Lanjutkan ke bagian berikutnya untuk memberikan instruksi untuk agen.

Menyiapkan instruksi agen

Agen memerlukan instruksi yang menjelaskan peran yang dapat dimainkan agen dan tugas yang dapat dilakukan agen. Untuk membantu agen mempelajari dan memahami tanggung jawab ini, Anda juga dapat menyertakan informasi berikut:

• Struktur alur kerja
• Tindakan yang tersedia
• Pembatasan atau batasan apa pun
• Interaksi untuk skenario tertentu atau kasus khusus

Untuk hasil terbaik, berikan instruksi preskriptif dan bersiaplah untuk menyempurnakan instruksi Anda secara berulang.

1. Dalam kotak Instruksi untuk agen , masukkan instruksi yang diperlukan agen untuk memahami peran dan tugasnya.

   Untuk contoh ini, contoh agen cuaca menggunakan contoh instruksi berikut di mana Anda kemudian mengajukan pertanyaan dan memberikan alamat email Anda sendiri untuk pengujian:

   You're an AI agent that answers questions about the weather for a specified location. You can also send a weather report in email if you're provided email address. If no address is provided, ask for an email address.
   
   Format the weather report with bullet lists where appropriate. Make your response concise and useful, but use a conversational and friendly tone. You can include suggestions like "Carry an umbrella" or "Dress in layers".
   

   Berikut adalah sebuah contoh:

   

2. Sekarang, Anda dapat menyimpan alur kerja Anda. Pada toolbar perancang, pilih Simpan.

Periksa kesalahan

Untuk memastikan alur kerja Anda tidak memiliki kesalahan pada tahap ini, ikuti langkah-langkah ini, berdasarkan aplikasi logika dan lingkungan pengembangan Anda.

Konsumsi (pratinjau)

1. Pada toolbar perancang, pilih Obrolan.

2. Di antarmuka klien obrolan, ajukan pertanyaan berikut: What is the current weather in Seattle?

3. Periksa apakah respons adalah apa yang Anda harapkan, misalnya:

   

4. Kembali ke alur kerja Anda di perancang.

5. Pada bilah samping alur kerja, di bawah Alat Pengembangan, pilih Jalankan riwayat.

6. Pada halaman Riwayat Eksekusi, dalam tabel run, pilih eksekusi alur kerja terbaru.

   Nota

   Jika halaman tidak menampilkan eksekusi apa pun, pada toolbar, pilih Refresh.

   Jika kolom Status memperlihatkan status Berjalan , alur kerja agen masih berfungsi.

   Tampilan pemantauan terbuka dan memperlihatkan operasi alur kerja dengan statusnya. Panel log Agen terbuka dan memperlihatkan instruksi agen yang Anda berikan sebelumnya. Panel juga memperlihatkan respons agen.

   

   Agen tidak memiliki alat apa pun untuk digunakan saat ini, yang berarti bahwa agen tidak dapat benar-benar mengambil tindakan tertentu, seperti mengirim email ke daftar pelanggan, sampai Anda membuat alat yang dibutuhkan agen untuk menyelesaikan tugas.

7. Kembali ke perancang. Pada toolbar tampilan pemantauan, pilih Edit.

Standar

Periksa kesalahan di portal Microsoft Azure

1. Pada toolbar perancang, pilih Obrolan.

2. Di antarmuka klien obrolan, ajukan pertanyaan berikut: What is the current weather in Seattle?

3. Periksa apakah respons adalah apa yang Anda harapkan, misalnya:

   

4. Kembali ke alur kerja Anda di perancang.

5. Pada bilah samping alur kerja, di bawah Alat, pilih Jalankan riwayat.

6. Pada halaman Jalankan riwayat , pada tab Jalankan riwayat , pilih eksekusi alur kerja terbaru.

   Nota

   Jika halaman tidak menampilkan eksekusi apa pun, pada toolbar, pilih Refresh.

   Jika kolom Status memperlihatkan status Berjalan , alur kerja agen masih berfungsi.

   Tampilan pemantauan terbuka dan memperlihatkan operasi alur kerja dengan statusnya. Panel log Agen terbuka dan memperlihatkan instruksi agen yang Anda berikan sebelumnya. Panel juga memperlihatkan respons agen.

   

   Namun, agen tidak memiliki alat apa pun untuk digunakan saat ini, yang berarti bahwa agen tidak dapat benar-benar mengambil tindakan tertentu, seperti mengirim email, sampai Anda membuat alat yang dibutuhkan agen untuk menyelesaikan tugas mereka. Anda bahkan mungkin mendapatkan email bahwa server email Anda menolak pesan.

7. Kembali ke perancang. Pada toolbar tampilan pemantauan, pilih Edit.

Periksa kesalahan di Visual Studio Code

1. Di jendela Explorer untuk proyek aplikasi logika Anda, perluas folder yang memiliki nama alur kerja, dan buka file workflow.json .

2. Pada menu pintasan file, pilih Gambaran Umum, yang memulai sesi debugging.

3. Pada halaman Gambaran Umum , pilih Obrolan.

4. Di antarmuka klien obrolan, ajukan pertanyaan berikut: What is the current weather in Seattle?

5. Periksa apakah respons adalah apa yang Anda harapkan, misalnya:

   

6. Kembali ke halaman Gambaran Umum .

7. Di bawah Riwayat eksekusi, pilih eksekusi alur kerja yang paling baru.

   Nota

   Jika halaman tidak menampilkan eksekusi apa pun, pada toolbar, pilih Refresh.

   Jika kolom Status memperlihatkan status Berjalan , alur kerja agen masih berfungsi.

   Tampilan pemantauan terbuka dan memperlihatkan operasi alur kerja dengan statusnya. Panel log Agen terbuka dan memperlihatkan instruksi agen yang Anda berikan sebelumnya. Panel juga memperlihatkan respons agen.

   Namun, agen tidak memiliki alat apa pun untuk digunakan saat ini, yang berarti bahwa agen tidak dapat benar-benar mengambil tindakan tertentu, seperti mengirim email, sampai Anda membuat alat yang dibutuhkan agen untuk menyelesaikan tugas mereka. Anda bahkan mungkin mendapatkan email bahwa server email Anda menolak pesan.

8. Pada toolbar debugging, pilih Hentikan untuk menutup sesi debugging.

9. Kembali ke perancang.

Membuat alat 'Periksa cuaca'

Agar agen dapat menjalankan tindakan bawaan yang tersedia di Azure Logic Apps, Anda harus membuat satu atau beberapa alat untuk digunakan agen. Alat harus berisi paling sedikit satu tindakan dan tidak boleh berisi selain tindakan. Agen memanggil alat dengan menggunakan argumen tertentu.

Dalam contoh ini, agen membutuhkan alat yang mendapatkan prakiraan cuaca. Anda dapat membangun alat ini dengan mengikuti langkah-langkah berikut:

1. Pada perancang, di dalam agen dan di bawah Tambahkan alat, pilih tanda plus (+) untuk membuka panel tempat Anda dapat menelusuri tindakan yang tersedia.

2. Pada panel Tambahkan tindakan , ikuti langkah-langkah umum untuk aplikasi logika Anda untuk menambahkan tindakan yang terbaik untuk skenario Anda.

   Contoh ini menggunakan tindakan MSN Weather bernama Dapatkan cuaca saat ini.

   Setelah Anda memilih tindakan, kontainer Alat dan tindakan yang dipilih muncul di agen pada perancang. Kedua panel informasi juga terbuka secara bersamaan.

   

3. Pada panel informasi alat, ganti nama alat untuk menjelaskan tujuannya. Untuk contoh ini, gunakan Get weather.

4. Pada tab Detail , untuk Deskripsi, masukkan deskripsi alat. Untuk contoh ini, gunakan Get the weather for the specified location.

   

   Di bawah Deskripsi, bagian Parameter Agen hanya berlaku untuk kasus penggunaan tertentu. Untuk informasi selengkapnya, lihat Membuat parameter agen.

5. Lanjutkan ke bagian berikutnya untuk mempelajari selengkapnya tentang parameter agen, kasus penggunaannya, dan cara membuatnya, berdasarkan kasus penggunaan ini.

Membuat parameter agen untuk tindakan 'Dapatkan cuaca saat ini'

Tindakan biasanya memiliki parameter yang mengharuskan Anda menentukan nilai yang akan digunakan. Tindakan dalam alat hampir sama kecuali satu pengecualian. Anda dapat membuat parameter agen yang digunakan agen untuk menentukan nilai parameter untuk tindakan dalam alat. Anda dapat menentukan output yang dihasilkan model, nilai dari sumber nonmodel, atau kombinasi. Untuk informasi selengkapnya, lihat Parameter agen.

Tabel berikut ini menjelaskan kasus penggunaan untuk membuat parameter agen dan tempat membuatnya, berdasarkan kasus penggunaan:

Untuk	Di mana mengatur parameter agen
Gunakan output yang dihasilkan model saja. Bagikan dengan tindakan lain di alat yang sama.	Mulai dari parameter tindakan. Untuk langkah-langkah mendetail, lihat Menggunakan output yang dihasilkan model saja.
Gunakan nilai nonmodel.	Tidak diperlukan parameter agen. Pengalaman ini sama dengan pengalaman penyiapan tindakan biasa di Azure Logic Apps tetapi diulang untuk kenyamanan dalam Menggunakan nilai dari sumber nonmodel.
Gunakan output yang dihasilkan model dengan nilai nonmodel. Bagikan dengan tindakan lain di alat yang sama.	Mulailah dari alat, di bagian Parameter Agen. Untuk langkah-langkah mendetail, lihat Menggunakan output model dan nilai nonmodel.

Gunakan output yang dihasilkan model saja

Untuk parameter tindakan yang hanya menggunakan output yang dihasilkan model, buat parameter agen dengan mengikuti langkah-langkah berikut:

1. Di alat, pilih tindakan untuk membuka panel informasi.

   Untuk contoh ini, tindakannya adalah Dapatkan cuaca saat ini.

2. Pada tab Parameter , pilih di dalam kotak parameter untuk memperlihatkan opsi parameter.

3. Di tepi kanan kotak Lokasi , pilih tombol bintang.

   Tombol ini memiliki tooltip berikut: Pilih untuk menghasilkan parameter agen.

   

   Jendela Buat parameter agen memperlihatkan bidang Nama, Jenis, dan Deskripsi , yang telah diisi sebelumnya dari parameter tindakan sumber.

   Tabel berikut ini menjelaskan bidang yang menentukan parameter agen:

   Pengaturan	Nilai	Description
   Nama	< agent-parameter-name>	Nama parameter agen.
   Type	< agent-parameter-data-type>	Jenis data parameter agen.
   Deskripsi	< agent-parameter-description>	Deskripsi parameter agen yang dengan mudah mengidentifikasi tujuan parameter.

   Nota

   Microsoft menyarankan agar Anda mengikuti definisi Swagger dari tindakan. Misalnya, untuk tindakan Dapatkan cuaca saat ini, yang berasal dari konektor "bersama" MSN Weather yang dihosting dan dikelola oleh Azure multitenant global, lihat artikel referensi teknis konektor MSN Weather.

4. Setelah Anda siap, pilih Kirim.

   Contoh berikut menunjukkan tindakan Dapatkan cuaca saat ini dengan parameter Agen lokasi :

   

5. Simpan alur kerja Anda.

Menggunakan nilai dari sumber nonmodel

Untuk nilai parameter tindakan yang hanya menggunakan nilai nonmodel, pilih opsi yang paling sesuai dengan kasus penggunaan Anda:

Menggunakan output dari operasi sebelumnya dalam alur kerja

Untuk menelusuri dan memilih dari output ini, ikuti langkah-langkah berikut:

1. Pilih di dalam kotak parameter, lalu pilih ikon kilat untuk membuka daftar konten dinamis.

2. Dari daftar, di bagian pemicu atau tindakan, pilih output yang Anda inginkan.

3. Simpan alur kerja Anda.

Menggunakan hasil dari ekspresi

Untuk membuat ekspresi, ikuti langkah-langkah berikut:

1. Pilih di dalam kotak parameter, lalu pilih ikon fungsi untuk membuka editor ekspresi.

2. Pilih dari fungsi yang tersedia untuk membuat ekspresi.

3. Simpan alur kerja Anda.

Untuk informasi selengkapnya, lihat Panduan referensi untuk fungsi ekspresi alur kerja di Azure Logic Apps.

Menggunakan output model dan nilai nonmodel

Beberapa skenario mungkin perlu menentukan nilai parameter tindakan yang menggunakan kedua output yang dihasilkan model dengan nilai nonmodel. Misalnya, Anda mungkin ingin membuat isi email yang menggunakan teks statis, output nonmodel dari operasi sebelumnya dalam alur kerja, dan output yang dihasilkan model.

Untuk skenario ini, buat parameter agen pada alat dengan mengikuti langkah-langkah berikut:

1. Pada desainer, pilih alat di mana Anda ingin membuat parameter agen.

2. Pada tab Detail , di bawah Parameter Agen, pilih Buat Parameter.

3. Perluas parameter agen baru, dan berikan informasi berikut yang sesuai dengan detail parameter tindakan.

   Untuk contoh ini, contoh tindakannya adalah Dapatkan cuaca saat ini.

   Nota

   Microsoft menyarankan agar Anda mengikuti definisi Swagger dari tindakan. Misalnya, untuk menemukan informasi ini untuk tindakan Dapatkan cuaca saat ini, lihat artikel referensi teknis konektor MSN Weather. Contoh tindakan disediakan oleh konektor terkelola MSN Weather, yang dihosting dan dijalankan di kluster bersama dalam Azure multitenancy.

   Pengaturan	Nilai	Description
   Nama	< agent-parameter-name>	Nama parameter agen.
   Type	< agent-parameter-data-type>	Jenis data parameter agen.
   Deskripsi	< agent-parameter-description>	Deskripsi parameter agen yang dengan mudah mengidentifikasi tujuan parameter. Anda dapat memilih dari opsi berikut atau menggabungkannya untuk memberikan deskripsi: - Teks literal biasa dengan detail seperti tujuan parameter, nilai yang diizinkan, pembatasan, atau batasan. - Keluaran dari operasi sebelumnya dalam alur kerja. Untuk menelusuri dan memilih output ini, pilih di dalam kotak Deskripsi , lalu pilih ikon petir untuk membuka daftar konten dinamis. Dari daftar, pilih output yang Anda inginkan. - Hasil dari ekspresi. Untuk membuat ekspresi, pilih di dalam kotak Deskripsi , lalu pilih ikon fungsi untuk membuka editor ekspresi. Pilih dari fungsi yang tersedia untuk membuat ekspresi.

   Setelah selesai, di bawah Parameter Agen, parameter agen baru muncul.

4. Pada perancang, di alat, pilih tindakan untuk membuka panel informasi tindakan.

5. Pada tab Parameter , pilih di dalam kotak parameter untuk menampilkan opsi parameter, lalu pilih ikon robot.

6. Dari daftar Parameter agen , pilih parameter agen yang Anda tentukan sebelumnya.

   Alat Dapatkan cuaca saat ini yang sudah selesai terlihat seperti contoh berikut:

   

7. Simpan alur kerja Anda.

Membuat alat 'Kirim email'

Untuk banyak skenario, agen biasanya membutuhkan lebih dari satu alat. Dalam contoh ini, agen memerlukan alat yang mengirim laporan cuaca dalam email.

Untuk membangun alat ini, ikuti langkah-langkah berikut:

1. Pada perancang, pada agen, di samping alat yang ada, pilih tanda plus (+) untuk menambahkan aksi.

2. Pada panel Tambahkan tindakan , ikuti langkah-langkah umum ini untuk memilih tindakan lain untuk alat baru Anda.

   Contohnya menggunakan tindakan Outlook.com bernama Kirim email (V2).

   Seperti sebelumnya, setelah Anda memilih tindakan, Alat baru dan tindakan baru muncul di dalam agen pada perancang secara bersamaan. Kedua panel informasi terbuka secara bersamaan.

   

3. Pada panel informasi alat, ganti nama alat untuk menjelaskan tujuannya. Untuk contoh ini, gunakan Send email.

4. Pada tab Detail , untuk Deskripsi, masukkan deskripsi alat. Untuk contoh ini, gunakan Send current weather by email.

   

Membuat parameter agen untuk tindakan 'Kirim email (V2)'

Kecuali untuk parameter agen yang berbeda untuk disiapkan untuk tindakan Kirim email (V2), langkah-langkah di bagian ini hampir sama dengan Buat parameter agen untuk tindakan 'Dapatkan cuaca saat ini'.

• Ikuti langkah-langkah umum sebelumnya untuk membuat parameter agen untuk nilai parameter dalam tindakan Kirim email (V2).

  Tindakan ini membutuhkan tiga parameter agen bernama To, Subject, dan Body. Untuk definisi Swagger dari tindakan ini, lihat Mengirim email (V2).

  Setelah selesai, contoh tindakan menggunakan parameter agen yang ditentukan sebelumnya seperti yang ditunjukkan di sini:

  

  Alat Kirim email yang sudah selesai terlihat seperti contoh berikut:

  

Praktik terbaik untuk agen dan alat

Bagian berikut memberikan rekomendasi, praktik terbaik, dan panduan lain yang dapat membantu Anda membangun agen dan alat yang lebih baik.

Agents

Panduan berikut memberikan praktik terbaik untuk agen.

Agen dan alat prototipe dengan aksi 'Susun'

Daripada menggunakan tindakan nyata dan koneksi langsung untuk membuat prototipe agen dan alat Anda, gunakan Tindakan Compose untuk "memalsukan" atau mensimulasikan tindakan nyata. Pendekatan ini memberikan manfaat berikut:

• Menyusun tindakan tidak menghasilkan efek samping, membuat tindakan ini berguna untuk pengembangan ide, desain, dan pengujian.

• Anda dapat membuat draf dan menyempurnakan instruksi agen, perintah, nama alat, dan deskripsi ditambah parameter dan deskripsi agen - semua tanpa harus menyiapkan dan menggunakan koneksi langsung.

• Saat Anda mengonfirmasi bahwa agen dan alat Anda hanya bekerja dengan tindakan Buat, Anda siap untuk mengganti dengan tindakan yang sebenarnya.

• Saat beralih ke tindakan aktual, Anda harus mengalihkan atau membuat ulang parameter agen untuk bekerja dengan tindakan aktual, yang mungkin memakan waktu.

Mengelola panjang konteks riwayat obrolan

Agen alur kerja mempertahankan riwayat atau konteks obrolan, termasuk pemanggilan alat, berdasarkan batas saat ini pada jumlah token atau pesan yang akan disimpan dan diteruskan ke model untuk interaksi berikutnya. Seiring waktu, riwayat agen tumbuh dan akhirnya melebihi batas panjang konteks model Anda, atau jumlah maksimum token input. Model berbeda dalam panjang konteksnya.

Misalnya, gpt-4o mendukung 128.000 token input di mana setiap token memiliki 3-4 karakter. Saat riwayat agen mendekati panjang konteks model, pertimbangkan untuk menghilangkan pesan kedaluwarsa atau tidak relevan agar tetap di bawah batas.

Berikut adalah beberapa pendekatan untuk mengurangi riwayat agen Anda:

• Kurangi ukuran hasil dari alat dengan menggunakan tindakan Susun. Untuk informasi selengkapnya, lihat Alat - Praktik terbaik.

• Buat instruksi dan petunjuk agen Anda dengan hati-hati untuk mengontrol perilaku model.

• Kemampuan eksperimental: Anda memiliki opsi untuk mencoba pengurangan obrolan sehingga Anda dapat mengurangi jumlah maksimum token atau pesan untuk disimpan dalam riwayat obrolan dan meneruskan ke model.

  Agen alur kerja memiliki parameter tingkat lanjut yang hampir sama dengan konektor penyedia layanan bawaan Azure OpenAI, kecuali untuk parameter tingkat lanjut Jenis Pengurangan Riwayat Agen , yang hanya ada di agen. Parameter ini mengontrol riwayat yang dipertahankan agen, berdasarkan jumlah maksimum token atau pesan.

  Kemampuan ini dalam pengembangan aktif dan mungkin tidak berfungsi untuk semua skenario. Anda dapat mengubah opsi Jenis Pengurangan Riwayat Agen untuk mengurangi batas token atau pesan. Anda kemudian menentukan batas numerik yang Anda inginkan.

  Untuk mencoba kemampuan, ikuti langkah-langkah berikut:

  1. Pada perancang, pilih bilah judul agen sehingga panel informasi akan terbuka.

  2. Pada tab Parameter , temukan bagian Parameter tingkat lanjut .

  3. Periksa apakah parameter bernama Jenis Pengurangan Riwayat Agen ada. Jika tidak, buka daftar Parameter tingkat lanjut , dan pilih parameter tersebut.

  4. Dari daftar Tipe Pengurangan Riwayat Agen , pilih salah satu opsi berikut:

     Option	Description
     Pengurangan jumlah token	Memperlihatkan parameter bernama Jumlah Token Maksimum. Menentukan jumlah maksimum token dalam riwayat agen untuk disimpan dan diteruskan ke model untuk interaksi berikutnya. Default berbeda berdasarkan model yang saat ini digunakan di Azure OpenAI Service. Batas defaultnya adalah 128.000.
     Pengurangan jumlah pesan	Memperlihatkan parameter bernama Batas Jumlah Pesan. Menentukan jumlah maksimum pesan dalam riwayat agen untuk disimpan dan diteruskan ke model untuk interaksi berikutnya. Tidak ada batas default.

Tools

Panduan berikut memberikan praktik terbaik untuk alat.

• Nama adalah nilai terpenting untuk alat. Pastikan nama tersebut singkat dan menjelaskan.

• Deskripsi alat ini memberikan konteks yang berguna dan bermanfaat untuk alat ini.

• Nama alat dan deskripsi memiliki batas karakter.

  Beberapa batasan diberlakukan oleh model di Azure OpenAI Service pada waktu proses, bukan saat Anda menyimpan perubahan dalam agen dalam alur kerja.

• Terlalu banyak alat dalam agen yang sama dapat memiliki efek negatif pada kualitas agen.

  Pedoman umum yang baik merekomendasikan bahwa agen menyertakan tidak lebih dari 10 alat. Namun, panduan ini bervariasi berdasarkan model yang Anda gunakan dari Azure OpenAI Service.

• Dalam alat, tindakan tidak perlu memiliki semua input mereka berasal dari model.

  Anda dapat mengontrol input tindakan mana yang berasal dari sumber non-model dan input mana yang berasal dari model. Misalnya, alat memiliki tindakan yang mengirim email. Anda dapat menyediakan isi email biasa dan sebagian besar statis tetapi menggunakan output yang dihasilkan model untuk bagian dari isi email tersebut.

• Sesuaikan atau ubah hasil alat sebelum Anda meneruskannya ke model.

  Anda dapat mengubah hasil dari alat sebelum masuk ke model dengan menggunakan tindakan Rangkai. Pendekatan ini memberikan manfaat berikut:

  • Tingkatkan kualitas respons dengan mengurangi konteks yang tidak relevan yang masuk ke model. Anda hanya memilih bidang yang Anda butuhkan dari respons besar.

  • Kurangi biaya penagihan untuk token yang masuk ke model dan hindari melebihi batas model pada panjang konteks, jumlah maksimum token yang masuk ke model. Anda hanya mengirim bidang yang Anda butuhkan.

  • Gabungkan hasil dari beberapa tindakan dalam alat.

  • Anda dapat meniru hasil alat untuk mensimulasikan hasil yang diharapkan dari tindakan aktual. Tindakan tiruan membuat data tidak berubah di sumbernya dan tidak dikenakan biaya untuk penggunaan sumber daya di luar Azure Logic Apps.

Parameter agen

Panduan berikut memberikan pedoman praktik terbaik terkait parameter agen.

• Nama adalah nilai terpenting untuk parameter agen. Pastikan nama tersebut singkat dan menjelaskan.

• Deskripsi parameter agen menyediakan konteks yang berguna dan bermanfaat untuk alat ini.

Memicu atau menjalankan alur kerja

Anda dapat memicu atau menjalankan alur kerja agen percakapan dengan cara berikut, berdasarkan lingkungan penyebaran:

Lingkungan	Description
Bukan untuk Produksi	Pada toolbar perancang alur kerja, pilih Obrolan untuk memulai sesi obrolan secara manual dengan agen percakapan di portal Microsoft Azure. Penting: Metode ini hanya ditujukan untuk aktivitas pengujian. Pengujian berbasis portal menggunakan kunci pengembang sementara. Pengguna eksternal atau sistem produksi tidak dapat menggunakan kunci ini. Untuk informasi selengkapnya, lihat Autentikasi dan otorisasi.
Produksi	Mengharuskan Anda menyiapkan autentikasi untuk pengguna atau klien eksternal seperti situs web, aplikasi seluler, bot, atau layanan Azure lainnya untuk mengakses agen percakapan. Mereka kemudian dapat memicu alur kerja dengan menggunakan URL klien obrolan.

Tabel berikut ini menjelaskan cara pengguna atau klien obrolan menggunakan URL klien obrolan untuk menjalankan alur kerja dalam produksi:

Jenis alur kerja	Penggunaan URL klien obrolan	Autentikasi yang diperlukan
Konsumsi	Buka URL di browser atau sematkan URL dalam elemen HTML iFrame .	OAuth 2.0 dengan ID Microsoft Entra
Standar	Buka URL di browser, sematkan URL dalam elemen iFrame , atau jika Anda menggunakan pemicu Permintaan , panggil URL HTTP pemicu.	Identitas terkelola atau Easy Auth

Untuk menyematkan URL klien obrolan dalam elemen HTML iFrame, gunakan format berikut:

Jenis alur kerja	Elemen HTML iFrame
Konsumsi	<iframe src="https://agents.<region>.logic.azure.com/scaleunits/<scale-unit-ID>/flows/<workflow-ID>/agentChat/IFrame" title="<chat-client-name>"></iframe>
Standar	<iframe src="https://<logic-app-name>.azurewebsites.net/api/agentsChat/<workflow-name>/IFrame" title="<chat-client-name>"></iframe>

Autentikasi dan otorisasi

Untuk aktivitas nonproduksi, seperti desain, pengembangan, dan pengujian cepat, portal Microsoft Azure menyediakan, mengelola, dan menggunakan kunci pengembang untuk menjalankan alur kerja Anda dan menjalankan tindakan atas nama Anda. Daftar berikut merekomendasikan beberapa praktik terbaik untuk menangani kunci pengembang ini:

• Gunakan kunci pengembang secara ketat dan hanya sebagai kemudahan pada saat desain untuk autentikasi dan otorisasi.

• Sebelum Anda mengekspos agen percakapan Anda ke agen lain, otomatisasi, atau populasi pengguna yang lebih luas, migrasikan ke SAS yang ditandatangani dengan pembatasan jaringan atau metode autentikasi dan otorisasi berikut untuk obrolan eksternal, berdasarkan jenis alur kerja agen percakapan Anda:

  Alur kerja	Authentication
  Konsumsi	OAuth 2.0 dengan ID Microsoft Entra
  Standar	Identitas terkelola terotomatisasi, Easy Auth (Autentikasi Layanan Aplikasi)

  Pada dasarnya, jika ada atau apa pun di luar sesi portal Microsoft Azure Anda perlu memanggil atau berinteraksi dengan alur kerja Anda, kunci pengembang tidak lagi sesuai.

Saat Anda siap merilis alur kerja agen ke produksi, pastikan untuk mengikuti langkah-langkah migrasi untuk mempersiapkan autentikasi dan otorisasi produksi. Untuk informasi selengkapnya, lihat Autentikasi dan otorisasi.

Migrasi ke autentikasi produksi

1. Pada sumber daya aplikasi logika Anda, siapkan autentikasi berikut, berdasarkan jenis alur kerja Anda:

   Alur kerja	Authentication
   Konsumsi	OAuth 2.0 dengan Microsoft Entra ID dengan membuat kebijakan otorisasi agen pada sumber daya aplikasi logika Anda. Untuk membuat kebijakan ini, ikuti langkah-langkah berikut: 1. Ikuti langkah-langkah umum untuk membuat kebijakan, tetapi dengan langkah-langkah berikutnya ini sebagai gantinya. 2. Pilih Azure Active Directory (AAD). 3. Pilih Aturan Otorisasi Agen (Untuk Agen Percakapan). 4. Di bawah ID Objek, masukkan ID objek untuk setiap pengguna, aplikasi, atau aplikasi perusahaan yang dapat mengakses agen. 5. Setelah selesai, pada toolbar, pilih Simpan. Untuk informasi selengkapnya, lihat: - Menemukan ID penting untuk pengguna - Objek perwakilan aplikasi dan layanan di ID Microsoft Entra
   Standar	Identitas terkelola terotomatisasi, Easy Auth (Autentikasi Layanan Aplikasi)

2. Terapkan pola akses yang memerlukan autentikasi.

3. Secara opsional, mengunci URL titik akhir pemicu apa pun dengan menonaktifkan atau meregenerasi URL SAS yang tidak digunakan.

4. Untuk menyertakan antarmuka klien obrolan eksternal di situs web atau di tempat lain untuk mendukung interaksi manusia, dapatkan URL klien obrolan dan sematkan URL dalam elemen HTML iFrame dengan mengikuti langkah-langkah berikut:

   1. Pada toolbar perancang atau bilah samping alur kerja, pilih Obrolan.

   2. Di bagian Esensial , salin atau pilih tautan URL Klien Obrolan , yang terbuka di tab browser baru.

   3. Sematkan URL klien obrolan dalam elemen HTML iFrame, yang menggunakan format berikut:

      Alur kerja	Elemen HTML iFrame
      Konsumsi	<iframe src="https://agents.<region>.logic.azure.com/scaleunits/<scale-unit-ID>/flows/<workflow-ID>/agentChat/IFrame" title="<chat-client-name>"></iframe>
      Standar	<iframe src="https://<logic-app-name>.azurewebsites.net/api/agentsChat/<workflow-name>/IFrame" title="<chat-client-name>"></iframe>

Memecahkan masalah migrasi autentikasi

Tabel berikut ini menjelaskan masalah umum yang mungkin Anda temui saat mencoba bermigrasi dari kunci pengembang ke Easy Auth, kemungkinan penyebabnya, dan tindakan yang dapat Anda ambil:

Gejala	Kemungkinan penyebabnya	Tindakan
Pengujian portal berfungsi, tetapi panggilan eksternal mendapatkan respons 401 .	Panggilan eksternal tidak memiliki token SAS yang ditandatangani yang valid atau token akses Easy Auth (hanya alur kerja Standar).	Gunakan URL pemicu alur kerja dengan SAS yang ditandatangani atau Siapkan Easy Auth (hanya alur kerja Standar).
Pengujian perancang berfungsi, tetapi panggilan Azure API Management gagal.	Panggilan API Management tidak memiliki informasi header yang diharapkan.	Tambahkan akuisisi token OAuth 2.0 dalam kebijakan API Management atau gunakan autentikasi identitas terkelola jika didukung.
Akses tidak konsisten setelah perubahan peran.	Sesi cache di portal Azure	- Keluar dan masuk kembali. - Dapatkan token baru.

Memecahkan masalah

Bagian ini menjelaskan panduan untuk membantu memecahkan masalah atau kesalahan yang mungkin Anda temui saat membuat atau menjalankan alur kerja agen.

Meninjau data pelaksanaan alat

Riwayat eksekusi alur kerja menyediakan informasi berguna yang membantu Anda mempelajari apa yang terjadi selama eksekusi tertentu. Untuk alur kerja agensi, Anda dapat menemukan input dan output pelaksanaan alat pada iterasi perulangan agen spesifik.

1. Pada menu alur kerja, di bawah Alat, pilih Jalankan riwayat untuk membuka halaman Jalankan riwayat .

2. Pada tab Jalankan riwayat , di kolom Pengidentifikasi , pilih eksekusi alur kerja yang Anda inginkan.

   Tampilan pemantauan terbuka untuk menampilkan status untuk setiap langkah.

3. Pilih agen yang ingin Anda periksa. Di sisi kanan, panel log Agen muncul.

   Panel ini memperlihatkan log agen, termasuk eksekusi alat selama interaksi.

4. Untuk mendapatkan data eksekusi alat pada titik tertentu, temukan titik tersebut di log agen, dan pilih referensi eksekusi alat, misalnya:

   

   Tindakan ini memindahkan Anda ke alat pencocokan dalam tampilan pemantauan. Agen menunjukkan jumlah iterasi saat ini.

5. Dalam tampilan pemantauan, pilih agen atau tindakan dengan input, output, dan properti yang ingin Anda tinjau.

   Contoh berikut menunjukkan tindakan yang dipilih untuk eksekusi alat yang dipilih sebelumnya:

   

   Jika Anda memilih agen, Anda dapat meninjau informasi berikut yang diteruskan ke model dan dikembalikan oleh model, misalnya:

   • Pesan input yang diteruskan ke model.
   • Pesan output yang dikembalikan dari model.
   • Alat-alat yang diminta oleh model untuk dipanggil oleh agen.
   • Hasil alat yang diteruskan kembali ke model.
   • Jumlah token yang digunakan setiap permintaan.

6. Untuk meninjau iterasi perulangan agen yang berbeda, di dalam agen, pilih panah kiri atau kanan.

Log di Application Insights

Jika Anda menyiapkan Application Insights atau telemetri tingkat lanjut untuk alur kerja, Anda dapat meninjau log untuk peristiwa agen, seperti tindakan lainnya. Untuk informasi selengkapnya, lihat Mengaktifkan dan melihat telemetri yang disempurnakan di Application Insights untuk alur kerja Standar di Azure Logic Apps.

Panjang konteks maksimum model terlampaui

Jika riwayat log agen Anda melebihi panjang konteks model, atau jumlah maksimum token input, Anda mendapatkan kesalahan yang terlihat seperti contoh berikut:

Panjang konteks maksimum model ini adalah 4097 token. Namun, Anda meminta 4927 token (3927 dalam pesan, 1000 dalam penyelesaian). Kurangi panjang pesan atau penyelesaian.

Coba kurangi batas jumlah token atau pesan yang disimpan dalam log oleh agen Anda dan memasukkan ke dalam model untuk interaksi berikutnya. Untuk contoh ini, Anda dapat memilih Pengurangan jumlah token dan mengatur Jumlah Token Maksimum ke angka di bawah panjang konteks maksimum yang dinyatakan kesalahan, yaitu 4097.

Untuk informasi selengkapnya, lihat Mengelola panjang konteks riwayat obrolan.

Membersihkan sumber daya contoh

Jika Anda tidak memerlukan sumber daya yang Anda buat untuk contoh, pastikan untuk menghapus sumber daya sehingga Anda tidak terus dikenakan biaya. Anda dapat mengikuti langkah-langkah ini untuk menghapus grup sumber daya yang berisi sumber daya ini, atau Anda dapat menghapus setiap sumber daya satu per satu.

1. Dalam kotak pencarian Azure, masukkan grup sumber daya, dan pilih Grup sumber daya.

2. Temukan dan pilih grup sumber daya yang berisi sumber daya untuk contoh ini.

3. Pada halaman Gambaran Umum , pilih Hapus grup sumber daya.

4. Saat panel konfirmasi muncul, masukkan nama grup sumber daya, dan pilih Hapus.

Konten terkait

• Alur kerja agen AI di Azure Logic Apps
• Lab: Membangun alur kerja agen percakapan pertama Anda di Azure Logic Apps
• Batas dan konfigurasi Azure Logic Apps
• Kuota dan batas layanan Azure OpenAI