Membangun agen kustom menggunakan Supervisor API (Beta)

Important

Fitur ini ada di Beta. Admin akun dapat mengontrol akses ke fitur ini dari halaman Pratinjau . Lihat Kelola Pratinjau Azure Databricks.

Anda dapat membangun agen Azure Databricks Apps yang menggunakan Supervisor API (Beta) untuk orkestrasi alih-alih mengelola perulangan agen dalam kode Anda sendiri. Hasilnya sama dengan penulisan agen kustom: Aplikasi yang disebarkan dengan UI obrolan, /invocations titik akhir, dan autentikasi. Perbedaannya adalah Azure Databricks menjalankan loop agen untuk Anda. agent.py Anda melakukan satu panggilan API, dan Azure Databricks menangani pemilihan alat, eksekusi, dan sintesis respons.

API Supervisor berfungsi dengan salah satu model fondasi yang didukung. model Ubah bidang untuk beralih penyedia tanpa menyentuh definisi alat atau logika handler Anda.

Kapan menggunakan API Supervisor

API Supervisor berfungsi dengan baik ketika agen Anda hanya menggunakan alat yang dihosting Azure Databricks dan tidak memerlukan logika kustom di antara panggilan alat. Gunakan perulangan agen kustom sebagai gantinya jika agen Anda memerlukan salah satu hal berikut:

  • Alat fungsi sisi klien (API Supervisor tidak dapat mencampur alat yang dihosting dan sisi klien dalam satu permintaan)
  • Titik akhir agen yang lainnya selain titik akhir Asisten Pengetahuan Agent Bricks
  • Pengalih kustom, input/output kustom, atau kontrol streaming mendetail
  • Logika Python kustom antara panggilan alat, seperti pencabangan bersyarkat atau manajemen status
  • Kontrol atas parameter inferensi seperti temperature

Untuk referensi API lengkap dan parameter yang didukung, lihat Supervisor API (Beta).

Persyaratan

Membangun agen kustom menggunakan API Supervisor

Titik awal yang direkomendasikan adalah membuat aplikasi baru dari templat aplikasi Databricks terbaru. Templat terbaru mencakup kemampuan bawaan use-supervisor-api untuk asisten pemrograman AI serta kemampuan add-tools untuk menambahkan alat yang dihosting.

Untuk membuat aplikasi baru dari templat, lihat Menulis agen AI dan menyebarkannya di Aplikasi Databricks.

Setelah aplikasi Anda disiapkan dari templat terbaru, buka proyek di asisten pengodian AI Anda dan jalankan:

Use the Supervisor API skill to update this agent to use the Databricks Supervisor API.

Keterampilan ini memperbarui agent_server/agent.py Anda untuk memanggil DatabricksOpenAI().responses.create() dengan alat yang dihosting, menggantikan perulangan agen manual. Ini juga menambahkan databricks-openai ketergantungan serta mencatat batasan versi beta.

Hasilnya adalah Aplikasi yang telah di-deploy yang sama, dengan UI obrolan, autentikasi, dan endpoint /invocations, tetapi dengan kode agen yang lebih sederhana. Untuk alur kerja penyebaran lengkap (sebarkan ke Aplikasi, tambahkan alat, evaluasi), lihat Menulis agen AI dan menyebarkannya di Aplikasi Databricks.

Alat dan parameter yang didukung

Untuk daftar lengkap jenis alat yang didukung, parameter permintaan, dan contoh kode, lihat Supervisor API (Beta).

Untuk setiap alat yang Anda tambahkan, berikan juga izin sumber daya yang sesuai di databricks.yml. Lihat keterampilan di add-tools dalam .claude/skills/ untuk contoh.

Langkah berikutnya

  • Last updated on