Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Berdayakan aplikasi web Anda yang ada dengan mengekspos kemampuannya ke Foundry Agent Service menggunakan OpenAPI. Banyak aplikasi web sudah menyediakan REST API, menjadikannya kandidat ideal untuk integrasi ke agen yang dapat memanggil REST API sebagai alat. Dengan menghubungkan Foundry Agent Service ke API ini, Anda dapat dengan cepat membuat agen yang kuat dan kaya fitur dengan sedikit kode.
Gambaran Umum
Spesifikasi OpenAPI menjelaskan REST API dalam format standar yang dapat dibaca mesin. Foundry Agent Service dapat menggunakan spesifikasi ini untuk menemukan dan memanggil kemampuan aplikasi web Anda secara otomatis sebagai alat dalam agen AI. Pendekatan ini memungkinkan Anda untuk:
- Memanfaatkan API yang ada: Mengubah titik akhir REST Anda saat ini menjadi alat yang dapat diakses AI tanpa perubahan kode
- Pertahankan standar API: Gunakan spesifikasi OpenAPI standar industri yang melayani konsumen manusia dan AI
- Aktifkan integrasi cepat: Tambahkan kemampuan baru ke agen hanya dengan memperbarui spesifikasi OpenAPI Anda
- Mempertahankan logika bisnis: Jaga agar kode aplikasi, keamanan, dan pola akses data Anda yang ada tidak berubah
- Menskalakan dengan layanan terkelola: Gunakan skalabilitas dan keandalan bawaan Foundry Agent Service
Pola ini sangat kuat karena sebagian besar aplikasi web modern sudah mengekspos REST API untuk fungsionalitas intinya. Dengan mendokumenkan API ini dengan spesifikasi OpenAPI, Anda membuatnya segera tersedia sebagai blok penyusun untuk agen cerdas.
Kapan menggunakan alat OpenAPI
Pertimbangkan untuk mengekspos aplikasi App Service Anda sebagai alat OpenAPI untuk agen Foundry saat:
- Anda memiliki REST API yang ada: Aplikasi Anda sudah menyediakan titik akhir HTTP yang terdefinisi dengan baik
- Anda ingin pengembangan agen yang cepat: Anda perlu membuat agen fungsional dengan cepat dengan kode kustom minimal
- Anda memerlukan definisi alat deklaratif: Anda lebih suka menjelaskan kemampuan melalui spesifikasi daripada pemrograman
- Anda ingin mendukung beberapa agen: API yang sama dapat melayani beberapa skenario agen dengan orkestrasi yang berbeda
- Anda memerlukan kontrak API yang jelas: Spesifikasi OpenAPI menyediakan dokumentasi dan validasi untuk agen dan pengembang manusia
Pendekatan ini bekerja sangat baik untuk aplikasi lini bisnis, alat internal, dan arsitektur layanan mikro di mana REST API membentuk batas alami antar komponen.
Cara kerja alat OpenAPI dengan agen
Integrasi mengikuti alur langsung:
- Tentukan API Anda: Membuat atau menghasilkan spesifikasi OpenAPI untuk titik akhir REST App Service Anda
- Daftar sebagai alat: Tambahkan API Anda ke Foundry Agent Service, menentukan lokasi spesifikasi OpenAPI
- Penemuan Agen: Agen secara otomatis mengenali operasi, parameter, dan format respons yang tersedia
- Pemanggilan runtime: Saat pengguna berinteraksi dengan agen, itu memanggil endpoint App Service Anda sesuai kebutuhan
- Pemrosesan hasil: Agen menginterpretasikan respons API dan menggabungkan hasil ke dalam percakapan
App Service menyediakan dukungan bawaan untuk pola autentikasi yang diperlukan untuk pemanggilan alat yang aman, termasuk identitas terkelola dan integrasi ID Microsoft Entra.