Mengembangkan aplikasi klien untuk agen AI

  • 5 menit

Tip

Lihat tab Teks dan gambar untuk detail selengkapnya!

Agen di Microsoft Foundry merangkum model, instruksi, dan alat yang diperlukan untuk melakukan tugas. Untuk membuat agen tersedia untuk pengguna, Anda dapat membangun aplikasi klien yang mengirimkan permintaan ke agen dan memproses responsnya.

Hubungkan ke agen

Agen yang sedang berjalan di Foundry menyediakan titik akhir yang mendukung protokol Respons OpenAI. Aplikasi dapat terhubung ke titik akhir ini dengan menggunakan OpenAI SDK, dan pengguna atau identitas aplikasi dengan izin yang sesuai dapat mengautentikasi dengan menggunakan Microsoft Entra ID.

Misalnya, Anda dapat mengembangkan aplikasi web untuk agen Riwayat Komputasi; yang memungkinkan pengguna mengirimkan permintaan ke agen.

Cuplikan layar aplikasi klien agen di Visual Studio Code.

Aplikasi klien dapat mencakup pengalaman pengguna atau logika aplikasi apa pun yang diperlukan skenario Anda. Terlepas dari desainnya, interaksi inti dengan agen mengikuti pola yang sama:

  1. Mengautentikasi dan membuat klien untuk titik akhir agen.
  2. Kirim permintaan pengguna dengan menggunakan API Respons.
  3. Proses respons dan sajikan kepada pengguna atau komponen aplikasi lain.

Menggunakan OpenAI SDK

Contoh Python berikut menggunakan DefaultAzureCredential untuk mendapatkan token akses Microsoft Entra dan membuat klien OpenAI yang dikonfigurasi untuk titik akhir agen. Sistem ini kemudian mengirimkan prompt melalui client.responses.create dan mencetak respons teks dari agen.

from azure.identity import DefaultAzureCredential, get_bearer_token_provider
from openai import OpenAI

# Get an OpenAI client for the agent
token = get_bearer_token_provider(
    DefaultAzureCredential(), 
    "https://ai.azure.com/.default")

client = OpenAI(
    api_key=token,
    base_url="https://ai-resrce.services.ai.azure.com/api/projects/ai-project/agents/computinghistorycode/endpoint/protocols/openai",
    default_query={"api-version": "v1"}) 

# Submit a prompt to the agent and print the response
response = client.responses.create(
    input="Who was Grace Hopper?")

print(response.output_text)

DefaultAzureCredential mendukung beberapa sumber kredensial, memungkinkan kode aplikasi yang sama untuk mengautentikasi dalam pengembangan lokal dan di lingkungan yang dihosting. Identitas yang terautentikasi harus memiliki izin untuk menggunakan proyek dan agen Foundry.

API Respons menyediakan cara yang konsisten bagi aplikasi dan layanan untuk berinteraksi dengan model dan agen. Dengan mengekspos agen melalui titik akhir yang kompatibel dengan OpenAI, Foundry memungkinkan Anda menggunakan pola SDK yang sudah dikenal sementara model, instruksi, dan alat agen tetap dikelola di Foundry.