Bagikan melalui


Panduan Mulai Cepat Microsoft Foundry

Dalam panduan cepat ini, Anda akan memulai penggunaan model dan agen di Foundry.

Anda akan:

  • Membuat respons dari model
  • Membuat agen dengan perintah yang ditentukan
  • Mengadakan percakapan bergiliran dengan agen

Prasyarat

  • Model yang diterapkan di Microsoft Foundry. Jika Anda tidak memiliki model, selesaikan Quickstart: Siapkan sumber daya Microsoft Foundry terlebih dahulu.
  • Bahasa runtime yang diperlukan, alat global, dan ekstensi Visual Studio Code sebagaimana dijelaskan dalam Menyiapkan lingkungan pengembangan Anda.

Mengatur variabel lingkungan dan mendapatkan kode

Simpan titik akhir proyek Anda sebagai variabel lingkungan. Atur juga nilai-nilai ini untuk digunakan dalam skrip Anda.

PROJECT_ENDPOINT=<endpoint copied from welcome screen>
AGENT_NAME="MyAgent"
MODEL_DEPLOYMENT_NAME="gpt-4.1-mini"

Ikuti di bawah ini atau dapatkan kode:

Masuk menggunakan perintah CLI az login untuk mengautentikasi sebelum menjalankan skrip Python Anda.

Menginstal dan mengautentikasi

Pastikan Anda menginstal versi pratinjau/prarilis paket yang benar seperti yang ditunjukkan di sini.

  1. Pasang paket ini, termasuk versi pratinjau azure-ai-projects. Versi ini menggunakan API proyek Foundry (baru) (pratinjau).

    pip install --pre "azure-ai-projects>=2.0.0b4"
    pip install python-dotenv
    
  2. Masuk menggunakan perintah CLI az login untuk mengautentikasi sebelum menjalankan skrip Python Anda.

Petunjuk / Saran

Kode menggunakan Azure AI Projects 2.x dan tidak kompatibel dengan Azure AI Projects 1.x. Lihat dokumentasi Foundry (klasik) untuk versi Azure AI Projects 1.x.

Mengobrol dengan model

Berinteraksi dengan model adalah blok penyusun dasar aplikasi AI. Kirim input dan terima respons dari model:

import os
from dotenv import load_dotenv
from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

load_dotenv()

print(f"Using PROJECT_ENDPOINT: {os.environ['PROJECT_ENDPOINT']}")
print(f"Using MODEL_DEPLOYMENT_NAME: {os.environ['MODEL_DEPLOYMENT_NAME']}")

project_client = AIProjectClient(
    endpoint=os.environ["PROJECT_ENDPOINT"],
    credential=DefaultAzureCredential(),
)

openai_client = project_client.get_openai_client()

response = openai_client.responses.create(
    model=os.environ["MODEL_DEPLOYMENT_NAME"],
    input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")

Setelah menjalankan kode, Anda akan melihat respons yang dihasilkan model di konsol (misalnya, puisi singkat atau jawaban atas perintah Anda). Ini mengonfirmasi titik akhir proyek, autentikasi, dan penyebaran model Anda berfungsi dengan benar.

Petunjuk / Saran

Kode menggunakan Azure AI Projects 2.x dan tidak kompatibel dengan Azure AI Projects 1.x. Lihat dokumentasi Foundry (klasik) untuk versi Azure AI Projects 1.x.

Membuat agen

Buat agen menggunakan model yang Anda sebarkan.

Agen mendefinisikan perilaku inti. Setelah dibuat, ini memastikan respons yang konsisten dalam interaksi pengguna tanpa mengulangi instruksi setiap kali. Anda dapat memperbarui atau menghapus agen kapan saja.

import os
from dotenv import load_dotenv
from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
from azure.ai.projects.models import PromptAgentDefinition

load_dotenv()

project_client = AIProjectClient(
    endpoint=os.environ["PROJECT_ENDPOINT"],
    credential=DefaultAzureCredential(),
)

agent = project_client.agents.create_version(
    agent_name=os.environ["AGENT_NAME"],
    definition=PromptAgentDefinition(
        model=os.environ["MODEL_DEPLOYMENT_NAME"],
        instructions="You are a helpful assistant that answers general questions",
    ),
)
print(f"Agent created (id: {agent.id}, name: {agent.name}, version: {agent.version})")

Output mengonfirmasi bahwa agen telah dibuat. Untuk tab SDK, Anda akan melihat nama agen dan ID yang dicetak ke konsol.

Petunjuk / Saran

Kode menggunakan Azure AI Projects 2.x dan tidak kompatibel dengan Azure AI Projects 1.x. Lihat dokumentasi Foundry (klasik) untuk versi Azure AI Projects 1.x.

Mengobrol dengan agen

Gunakan agen yang dibuat sebelumnya bernama "MyAgent" untuk berinteraksi dengan mengajukan pertanyaan dan tindak lanjut terkait. Percakapan menyimpan riwayat dari semua interaksi ini.

import os
from dotenv import load_dotenv
from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

load_dotenv()

project_client = AIProjectClient(
    endpoint=os.environ["PROJECT_ENDPOINT"],
    credential=DefaultAzureCredential(),
)

agent_name = os.environ["AGENT_NAME"]
openai_client = project_client.get_openai_client()

# Optional Step: Create a conversation to use with the agent
conversation = openai_client.conversations.create()
print(f"Created conversation (id: {conversation.id})")

# Chat with the agent to answer questions
response = openai_client.responses.create(
    conversation=conversation.id, #Optional conversation context for multi-turn
    extra_body={"agent_reference": {"name": agent_name, "type": "agent_reference"}},
    input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")

# Optional Step: Ask a follow-up question in the same conversation
response = openai_client.responses.create(
    conversation=conversation.id,
    extra_body={"agent_reference": {"name": agent_name, "type": "agent_reference"}},
    input="And what is the capital city?",
)
print(f"Response output: {response.output_text}")

Anda melihat respons agen terhadap kedua perintah. Respons tindak lanjut menunjukkan bahwa agen mempertahankan riwayat percakapan secara bergiliran.

Petunjuk / Saran

Kode menggunakan Azure AI Projects 2.x dan tidak kompatibel dengan Azure AI Projects 1.x. Lihat dokumentasi Foundry (klasik) untuk versi Azure AI Projects 1.x.

Membersihkan sumber daya

Jika Anda tidak lagi memerlukan sumber daya yang Anda buat, hapus grup sumber daya yang terkait dengan proyek Anda.

  • Di portal Microsoft Azure, pilih grup sumber daya, lalu pilih Hapus. Konfirmasikan bahwa Anda ingin menghapus grup sumber daya.

Langkah selanjutnya