Siklus hidup pengembangan agen

Siklus hidup pengembangan agen di Microsoft Foundry mencakup dari pembuatan awal melalui pemantauan produksi. Inti dari setiap agen adalah model dari katalog model Foundry yang mendorong penalaran dan pembuatan respons. Mengikuti siklus hidup ini membantu Anda membangun agen yang andal, menangkap masalah lebih awal, dan mengirim dengan percaya diri. Gunakan portal atau kode Foundry untuk membangun, menyesuaikan, dan menguji perilaku agen Anda. Kemudian iterasi dengan pelacakan, evaluasi, dan pemantauan untuk meningkatkan kualitas dan keandalan. Setelah siap, terbitkan agen Anda sebagai aplikasi agen untuk membagikannya dan mengintegrasikannya ke dalam aplikasi Anda.

Artikel ini untuk pengembang yang ingin membangun, menguji, dan mengirim agen siap produksi.

Prasyarat

Siklus hidup sekilas

Gunakan siklus hidup ini sebagai daftar periksa praktis saat Anda mengembangkan dan mengirimkan agen perangkat lunak.

  1. Pilih jenis agen: Mulailah dengan agen berbasis perintah atau agen yang Dihosting.
  2. Buat agen Anda dan mulai pengujian: Lakukan iterasi di sandbox atau dalam kode.
  3. Tambahkan alat dan data: Tambahkan alat untuk pengambilan data dan tindakan, pastikan konfigurasi telah divalidasi sebelum menyimpan.
  4. Simpan perubahan sebagai versi: Ambil tonggak pencapaian yang bermakna dan bandingkan versi.
  5. Debug dengan pelacakan: Gunakan pelacakan untuk mengonfirmasi panggilan alat, latensi, dan perilaku end-to-end. Untuk detailnya, lihat Ringkasan pelacakan agen.
  6. Mengevaluasi kualitas dan keamanan: Jalankan evaluasi berulang untuk menangkap regresi sebelum menerbitkan. Untuk panduan konseptual, lihat Penilai Agen.
  7. Optimalkan agen yang dihosting (pratinjau): Optimalkan instruksi agen yang dihosting Anda secara otomatis dan temukan keterampilan dengan pengoptimal agen.
  8. Menerbitkan dan mengintegrasikan: Menerbitkan titik akhir yang stabil dan mengintegrasikannya ke dalam aplikasi Anda. Untuk langkah-langkahnya, lihat aplikasi Agent di Microsoft Foundry.
  9. Pantau dan iterasi: Pantau performa dan kualitas dalam produksi, lalu perbarui dan terbitkan ulang sesuai kebutuhan. Untuk panduan, lihat Monitoring agen.

Jenis agen di Microsoft Foundry

Ada dua jenis agen:

  • Berbasis perintah: Agen berbasis perintah adalah agen tunggal yang ditentukan secara deklaratif yang menggabungkan model, instruksi, alat, dan permintaan bahasa alami Foundry untuk mendorong perilaku. Perluas dengan melampirkan alat untuk pengetahuan dan memori. Edit, buat versi, uji, evaluasi, pantau, dan terbitkan agen berbasis perintah dari playground Agen di portal Foundry.

  • Dihosting: Agen yang dihosting adalah agen kontainer yang Anda buat dalam kode dengan menggunakan kerangka kerja atau kode kustom yang didukung. Foundry Agent Service menyebarkan dan mengelola agen ini. Anda tidak dapat mengedit agen yang dihosting di UI pembuatan agen, namun Anda tetap dapat menjalankan, mengevaluasi, memantau, dan menerbitkannya. Untuk detailnya, lihat Apa itu agen yang dihosting?

Buat agen berbasis prompt di portal Foundry atau lingkungan pengembangan Anda sendiri dengan menggunakan CLI, SDK, atau REST API. Untuk informasi selengkapnya, lihat panduan cepat.

Membuat agen berbasis perintah

Jika Anda sudah tahu jenis agen apa yang ingin Anda buat, beri nama lalu mulai konfigurasikan instruksi dan alat modelnya.

Catatan

Setelah Anda memberi nama agen Anda, Anda tidak dapat mengubah namanya. Dalam kode, Anda merujuk ke agen Anda dengan <agent_name>:<version>.

Mengembangkan agen dalam kode

Jika Anda lebih suka bekerja dalam kode, gunakan cara yang didukung untuk membawa kode agen Anda ke lingkungan pengembangan tempat Anda dapat menguji secara lokal lalu menyebarkan ke Azure.

Dari tab Code di panel obrolan agen playground, Anda dapat mengambil cuplikan kode yang mereferensikan agen Anda ke Visual Studio Code khusus untuk lingkungan cloud Web. Cuplikan ini telah dikonfigurasi sebelumnya dengan paket dan ekstensi yang Anda butuhkan, bersama dengan instruksi untuk mengembangkan dan menyebarkan agen Foundry Anda secara efisien untuk Azure. Anda juga dapat menyalin cuplikan kode langsung ke lingkungan pengembangan pilihan Anda. Untuk detailnya, lihat dokumentasi taman bermain.

Kemampuan inti untuk siklus hidup pengembangan agen

Pengalaman membangun agen menawarkan pengalaman terintegrasi untuk setiap langkah inti siklus hidup pengembangan agen. Gunakan kemampuan inti ini saat Anda mengembangkan aplikasi agen siap produksi Anda. Setiap kemampuan memiliki dokumentasi mendalam di mana Anda dapat mempelajari lebih lanjut.

Simpan perubahan sebagai versi

Setelah Anda membuat versi pertama agen berbasis perintah, simpan perubahan berikutnya sebagai versi baru. Anda dapat menguji perubahan yang belum disimpan di lingkungan uji coba agen. Tetapi jika Anda ingin melihat riwayat percakapan, memantau performa agen Anda, atau menjalankan evaluasi penuh, Anda perlu menyimpan perubahan Anda.

Versi agen menyediakan kemampuan berikut untuk mengelola konfigurasi dan iterasi agen. Sistem ini memastikan bahwa semua perubahan dilacak, dapat diuji, dan sebanding di seluruh versi.

  • Imutabilitas versi: Setiap versi agen tidak dapat diubah setelah Anda menyimpannya. Setiap modifikasi pada versi yang ada memerlukan penyimpanan dan pembuatan versi baru. Persyaratan ini membantu memastikan integritas versi dan mencegah penimpaan yang tidak disengaja.

  • Manajemen status draf: Anda dapat menguji agen pada kondisi tidak disimpan untuk eksperimen. Anda kehilangan perubahan yang tidak disimpan jika Anda meninggalkan portal Foundry, jadi sering simpan untuk mempertahankan modifikasi penting.

  • Operasi kontrol versi: Anda dapat mengarahkan permintaan ke versi agen tertentu untuk mengaktifkan kemampuan penyebaran dan pemutaran kembali yang dikontrol.

  • Navigasi riwayat versi: Akses riwayat versi untuk agen apa pun, buka versi tertentu, dan lakukan perbandingan berikut:

    Jenis perbandingan Deskripsi
    Penyiapan agen Bandingkan pengaturan konfigurasi antar versi menggunakan menu tarik-turun versi
    Output obrolan Menganalisis perbedaan respons antara versi agen menggunakan input yang identik
    Definisi YAML Meninjau perbedaan dalam definisi agen

Agen referensi menggunakan pola get-or-create yang stabil

Dalam kode, Anda merujuk ke agen dengan <agent_name>:<version>. Buat setiap agen sekali, lalu pertahankan dan gunakan kembali pengidentifikasi tersebut di seluruh sesi dan proses.

  • Buat sekali, gunakan kembali ID. Simpan di cache nama atau ID agen yang dibutuhkan oleh aplikasi Anda. Jangan membuat ulang itu setiap kali dijalankan.
  • Perlakukan 404 sebagai terminal. Jika GET, run, atau panggilan use mengembalikan 404 Not Found untuk ID yang sebelumnya Anda buat, agen tersebut telah dihapus. Buat ulang. Jangan ulangi ID yang sama dalam satu perulangan.
  • Lebih suka get-or-create. Saat startup, cari agen berdasarkan nama dan buat agen tersebut hanya jika pencarian tersebut mengembalikan 404. Pendekatan ini mempertahankan satu ID yang stabil dan menghindari duplikat yatim.

Menambahkan alat

Jadikan agen Anda lebih kuat dengan memberinya pengetahuan (file atau indeks tertentu) atau dengan memungkinkannya untuk mengambil tindakan (memanggil API eksternal). Alat tersedia untuk sebagian besar kasus penggunaan, dari unggahan file sederhana hingga koneksi server Model Context Protocol (MCP) kustom. Untuk alat yang lebih rumit, Anda mungkin perlu mengonfigurasi autentikasi atau menambahkan koneksi sebagai bagian dari melampirkannya ke agen.

Untuk menyimpan agen dengan alat terlampir, Anda harus mengonfigurasi alat tersebut dengan sukses. Gunakan kembali alat yang dikonfigurasi di seluruh agen. Untuk informasi tentang cara menambahkan alat untuk agen menggunakan Kotak Alat dan apa yang tersedia, lihat Gambaran Umum Kotak Alat.

Men-debug dan memvalidasi dengan menggunakan pelacakan (pratinjau)

Saat Anda menambahkan alat dan melakukan iterasi pada perintah, gunakan pelacakan untuk memvalidasi perilaku end-to-end:

  • Konfirmasi apakah agen memanggil alat yang Anda harapkan.
  • Periksa input dan output alat.
  • Identifikasi titik utama latensi di seluruh panggilan model dan alat.

Untuk informasi selengkapnya, lihat Gambaran umum pelacakan agen.

Mengevaluasi kualitas dan keamanan (pratinjau)

Sebelum Anda menerbitkan agen Anda (dan setelah perubahan yang bermakna), lakukan evaluasi untuk menemukan regresi dan mengukur kualitas secara konsisten pada setiap versi.

Memantau setelah penerbitan

Setelah Anda menerbitkan aplikasi agen, perlakukan seperti perangkat lunak produksi:

  • Pantau sinyal kualitas dan keamanan.
  • Tinjau jejak saat perilaku berubah.
  • Perbarui dan terbitkan ulang saat Anda memperbaiki masalah atau melakukan penyempurnaan.

Untuk panduan, lihat Melacak agen.

Merencanakan identitas dan izin

Alat dan sumber daya hilir sering memerlukan autentikasi. Saat Anda menerbitkan agen, model identitas dan izinnya dapat berubah. Pastikan agen yang Anda terbitkan hanya memiliki akses yang dibutuhkan.

Untuk detailnya, lihat konsep identitas Agent di Microsoft Foundry.

Keamanan dan akses

Perlakukan konfigurasi agen Anda seperti kode aplikasi. Lindungi rahasia dan izin sepanjang siklus hidup:

  • Gunakan prinsip hak istimewa terendah dan penetapan peran alih-alih menyematkan kunci secara langsung. Untuk informasi selengkapnya, lihat Kontrol akses berbasis peran di portal Foundry.
  • Simpan rahasia di penyimpanan rahasia terkelola dan referensikan melalui koneksi alih-alih mengodekannya dalam kode, file konfigurasi, atau perintah. Untuk panduan, lihat Siapkan koneksi Key Vault.
  • Sebelum menerbitkan, konfirmasikan bahwa identitas agen dan koneksi alat di aplikasi agen yang diterbitkan hanya memiliki akses yang mereka butuhkan. Untuk detailnya, lihat konsep identitas Agent di Microsoft Foundry.

Terbitkan agen Anda

Setelah Anda membuat versi agen yang Anda senangi, terbitkan sebagai aplikasi agen. Anda mendapatkan titik akhir stabil yang dapat Anda buka dan uji di browser, berbagi dengan orang lain, atau menyematkan di aplikasi yang ada. Anda dan kolaborator Anda dapat memvalidasi performa dan mengidentifikasi apa yang perlu diperbaiki. Buat pembaruan yang diperlukan dan terbitkan ulang versi baru kapan saja.

Penting

Izin yang diberikan pada identitas proyek tidak secara otomatis ditransfer ke agen yang diterbitkan. Setelah menerbitkan, atur ulang hak istimewa yang diperlukan ke identitas aplikasi agen.

Kesalahan umum dalam pengembangan agen

  • Perubahan yang belum disimpan bersifat sementara: Jika Anda ingin membandingkan versi, melihat riwayat, atau menjalankan evaluasi penuh, simpan perubahan Anda sebagai versi.
  • Alat harus dikonfigurasi sebelum menyimpan: Jika alat memerlukan autentikasi atau koneksi, selesaikan penyiapan sebelum Anda menyimpan.
  • Penerbitan dapat memerlukan pembaruan izin: Setelah penerbitan, memeriksa ulang akses sumber daya untuk identitas agen yang diterbitkan dan menghapus akses apa pun yang tidak dibutuhkan agen lagi.
  • Menggunakan kembali ID agen yang dihapus: ID agen tidak valid saat agen dihapus. Panggilan yang mereferensikan ID yang dihapus atau tidak pernah dibuat akan mengembalikan 404 Not Found. Perlakukan 404 untuk ID yang valid sebelumnya sebagai terminal. Buat ulang agen (atau gunakan pola get-or-create) alih-alih mencoba kembali ID yang sama. Melakukan polling berulang kali pada ID yang telah dihapus tidak akan pernah berhasil dan hanya menghasilkan trafik kesalahan.

Konten terkait

Pelajari selengkapnya tentang jenis agen:

Mengonfigurasi dan memperluas agen:

Meluncurkan dan memantau agen:

Debug dan evaluasi:

  • Last updated on