Rövid útmutató: Ismerkedés a Microsoft Foundry SDK-val

Ebben a rövid útmutatóban megkezdheti a modellek és ügynökök használatát a Foundryben.

A következőket fogja csinálni:

  • Válasz létrehozása modellből
  • Ügynök létrehozása meghatározott kéréssel
  • Több fordulón át tartó beszélgetést folytatni az ügynökkel

Előfeltételek

  • A Microsoft Foundryben üzembe helyezett modell. Ha nem rendelkezik modellel, először végezze el a Gyorsútmutató: Microsoft Foundry erőforrások beállítása.

    Tipp

    Vagy hagyja ki az üzembe helyezési lépést, és próbálkozzon inkább egy azonnali modellel (előzetes verzió). Hozzon létre egy projektet az USA 3 nyugati régiójában az azonnali hozzáférési modellek használatához.

  • A fejlesztési környezet előkészítése részben leírt szükséges nyelvi futtatókörnyezetek, globális eszközök és Visual Studio Code bővítmények.

Környezeti változók beállítása és a kód lekérése

A projektvégpontot környezeti változóként tárolhatja. Ezeket az értékeket a szkriptekben való használatra is beállíthatja.

PROJECT_ENDPOINT=<endpoint copied from welcome screen>
AGENT_NAME="MyAgent"

Kövesse az alábbi lépéseket, vagy kérje le a kódot:

Jelentkezzen be a CLI az login paranccsal a hitelesítéshez a Python szkriptek futtatása előtt.

Telepítés és hitelesítés

Győződjön meg arról, hogy a csomagok megfelelő verzióját telepíti az itt látható módon.

  1. Telepítse a azure-ai-projectsaktuális verzióját. Ez a verzió az Foundry-projektek (új) API-t használja.

    pip install azure-ai-projects>=2.3.0
    
  2. Jelentkezzen be a CLI az login paranccsal a hitelesítéshez a Python szkriptek futtatása előtt.

Tipp

A kód Azure AI-projekteket használ 2.x és nem kompatibilis Azure AI-projektekkel 1.x. Tekintse meg a Foundry (klasszikus) dokumentációját az Azure AI Projects 1.x verziójához.

Egy modellel való csevegés

A modellekkel való interakció az AI-alkalmazások alapvető építőeleme. Adjon meg egy bemenetet, és kapjon választ a modelltől:

import os

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = os.getenv("AZURE_AI_PROJECT_ENDPOINT", "your_project_endpoint")
MODEL_DEPLOYMENT = os.getenv("MODEL_DEPLOYMENT", "gpt-5-mini")

# Create project and openai clients to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
openai = project.get_openai_client()

# Run a responses API call
response = openai.responses.create(
    model=MODEL_DEPLOYMENT,
    input="What is the size of France in square miles?",
)
if not response.output_text or not response.output_text.strip():
    raise RuntimeError("Response output text was empty.")

print(f"Response output: {response.output_text}")

A kód futtatása után megjelenik egy modell által generált válasz a konzolon (például egy rövid vers vagy a kérdésre adott válasz). Ez megerősíti, hogy a projektvégpont, a hitelesítés és a modell üzembe helyezése megfelelően működik.

Tipp

A kód Azure AI-projekteket használ 2.x és nem kompatibilis Azure AI-projektekkel 1.x. Tekintse meg a Foundry (klasszikus) dokumentációját az Azure AI Projects 1.x verziójához.

Ügynök létrehozása

Készítsen egy ügynököt az üzembe helyezett modell használatával.

Az ügynök határozza meg az alapvető viselkedést. A létrehozás után konzisztens válaszokat biztosít a felhasználói interakciókban anélkül, hogy minden alkalommal megismételte volna az utasításokat. Az ügynököket bármikor frissítheti vagy törölheti.

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
from azure.ai.projects.models import PromptAgentDefinition

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = "your_project_endpoint"
AGENT_NAME = "your_agent_name"

# Create project client to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)

# Create an agent with a model and instructions
agent = project.agents.create_version(
    agent_name=AGENT_NAME,
    definition=PromptAgentDefinition(
        model="gpt-5-mini",  # supports all Foundry direct models"
        instructions="You are a helpful assistant that answers general questions",
    ),
)
print(f"Agent created (id: {agent.id}, name: {agent.name}, version: {agent.version})")

Az eredmény megerősíti, hogy az ügynök sikeresen létre lett hozva. Az SDK-lapok esetében megjelenik a konzolra nyomtatott ügynök neve és azonosítója.

Tipp

A kód Azure AI-projekteket használ 2.x és nem kompatibilis Azure AI-projektekkel 1.x. Tekintse meg a Foundry (klasszikus) dokumentációját az Azure AI Projects 1.x verziójához.

Csevegés ügynökkel

A korábban létrehozott "MyAgent" nevű ügynökkel kapcsolatba léphet egy kérdés feltevésével és egy kapcsolódó nyomon követéssel. A beszélgetés ezen interakciók során megőrzi az előzményeket.

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

# Format: "https://resource_name.ai.azure.com/api/projects/project_name"
PROJECT_ENDPOINT = "your_project_endpoint"
AGENT_NAME = "your_agent_name"

# Create project and openai clients to call Foundry API
project = AIProjectClient(
    endpoint=PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
# Get an OpenAI client pre-bound to the specified agent
openai = project.get_openai_client(agent_name=AGENT_NAME)

# Create a conversation for multi-turn chat
conversation = openai.conversations.create()

# Chat with the agent to answer questions
response = openai.responses.create(
    conversation=conversation.id,
    input="What is the size of France in square miles?",
)
print(response.output_text)

# Ask a follow-up question in the same conversation
response = openai.responses.create(
    conversation=conversation.id,
    input="And what is the capital city?",
)
print(response.output_text)

Megjelenik az ügynök válasza mindkét kérdésre. Az utókövetési válasz azt mutatja, hogy az ügynök több fordulón keresztül tartja fenn a beszélgetési előzményeket.

Tipp

A kód Azure AI-projekteket használ 2.x és nem kompatibilis Azure AI-projektekkel 1.x. Tekintse meg a Foundry (klasszikus) dokumentációját az Azure AI Projects 1.x verziójához.

Erőforrások törlése

Ha már nincs szüksége a létrehozott erőforrásokra, törölje a projekthez társított erőforráscsoportot.

  • A Azure portálon jelölje ki az erőforráscsoportot, majd válassza a Delete lehetőséget. Győződjön meg arról, hogy törölni szeretné az erőforráscsoportot.

Következő lépés