Menambahkan alat ke agen Azure AI

  • 5 menit

Di Microsoft Agent Framework, alat memungkinkan agen AI Anda menggunakan API dan layanan yang ada untuk melakukan tugas yang tidak dapat dilakukannya sendiri. Alat berfungsi melalui panggilan fungsi, memungkinkan AI untuk secara otomatis meminta dan menggunakan fungsi tertentu. Kerangka kerja merutekan permintaan ke fungsi yang sesuai di basis kode Anda dan mengembalikan hasilnya kembali ke model bahasa besar (LLM) sehingga dapat menghasilkan respons akhir.

Untuk mengaktifkan panggilan fungsi otomatis, alat perlu memberikan detail yang menjelaskan cara kerjanya. Input, output, dan tujuan fungsi harus dijelaskan dengan cara yang dapat dipahami AI, jika tidak, AI tidak dapat memanggil fungsi dengan benar.

Cara menggunakan alat dengan Microsoft Foundry Agent

Microsoft Agent Framework mendukung alat fungsi kustom dan alat bawaan yang siap digunakan di luar kotak.

Perangkat bawaan

Microsoft Foundry Agents dilengkapi dengan beberapa alat bawaan yang dapat Anda gunakan segera:

  • Penerjemah Kode - menjalankan kode Python untuk perhitungan, analisis data, dan banyak lagi
  • Pencarian File - mencari melalui dan menganalisis dokumen
  • Pencarian Web - mengambil informasi dari internet

Alat-alat ini tersedia secara otomatis dan tidak memerlukan penyiapan tambahan.

Perangkat fungsi khusus

Saat membuat alat kustom untuk Microsoft Foundry Agent, Anda perlu memahami beberapa konsep utama:

  1. Definisi fungsi dan anotasi

    Buat alat Anda dengan mendefinisikan fungsi Python reguler dengan anotasi jenis yang tepat. Gunakan Annotated dan Field dari Pydantic untuk memberikan deskripsi terperinci yang membantu AI memahami tujuan fungsi dan cara menggunakan parameternya. Semakin deskriptif anotasi Anda, semakin baik AI dapat memahami kapan dan bagaimana memanggil fungsi Anda.

  2. Menambahkan alat ke agen Anda

    Teruskan fungsi kustom Anda ke ChatAgent selama pembuatan menggunakan tools parameter . Anda dapat menambahkan satu fungsi atau daftar beberapa fungsi. Kerangka kerja secara otomatis mendaftarkan fungsi-fungsi ini dan membuatnya tersedia untuk dipanggil oleh AI.

  3. Pemanggilan alat melalui percakapan

    Setelah alat Anda terdaftar di agen, Anda tidak perlu memanggilnya secara manual. Sebagai gantinya, ajukan pertanyaan agen atau berikan tugas yang secara alami memerlukan fungsionalitas alat Anda. AI secara otomatis menentukan kapan harus memanggil alat Anda berdasarkan konteks percakapan dan deskripsi alat yang Anda berikan.

  4. Beberapa alat dan orkestrasi

    Anda dapat menambahkan beberapa alat ke satu agen, dan AI secara otomatis memilih alat mana yang akan digunakan berdasarkan permintaan pengguna. Kerangka kerja menangani orkestrasi, memanggil fungsi yang sesuai dan menggabungkan hasilnya untuk memberikan respons yang komprehensif.

Praktik terbaik untuk pengembangan alat

  • Deskripsi yang jelas: Menulis deskripsi yang jelas dan terperinci untuk fungsi dan parameter Anda untuk membantu AI memahami tujuannya
  • Ketik anotasi: Gunakan petunjuk jenis Python yang tepat untuk menentukan jenis input dan output yang diharapkan
  • Penanganan kesalahan: Terapkan penanganan kesalahan yang sesuai dalam fungsi alat Anda untuk menangani input yang tidak terduga dengan baik
  • Mengembalikan data yang bermakna: Pastikan fungsi Anda mengembalikan data yang dapat digunakan AI secara efektif dalam responsnya
  • Menjaga fungsi tetap fokus: Merancang setiap alat untuk menangani tugas tertentu daripada mencoba melakukan terlalu banyak hal dalam satu fungsi

Dengan mengikuti konsep ini, Anda dapat memperluas Microsoft Foundry Agent dengan alat bawaan dan kustom, memungkinkannya berinteraksi dengan API dan melakukan tugas tingkat lanjut. Pendekatan ini membuat AI Anda lebih kuat dan mampu menangani aplikasi dunia nyata secara efisien.