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. Az azonnali modellek nem rendelkeznek üzembe helyezéssel, ezért használja a modell nevét gpt-5-mini , ahol a minták az üzembe helyezés nevét kérik.

  • 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.

A kód lekérése és az értékek beállítása

A Python minták nem olvasnak környezeti változókat. Minden fájlban cserélje le ezeket a helyőrző értékeket:

  • your_project_endpoint: A projekt végpontja, a következő formátumban: https://<resource-name>.services.ai.azure.com/api/projects/<project-name>.
  • your_agent_name: Az ügynök neve, például MyAgent.

A minták az Microsoft Foundry-erőforrások beállítása című részben létrehozott gpt-5-mini telepítést használják. Ha egy modellt más néven helyezett üzembe, frissítse a modell nevét a mintakódban.

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

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ó a Foundry-projektek (új) API-t használja. A minták hitelesítése a DefaultAzureCredential használatával történik, amely a azure-identity származik.

    pip install "azure-ai-projects>=2.3.0" azure-identity
    
  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:

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

# Format: "https://resource_name.services.ai.azure.com/api/projects/project_name"
FOUNDRY_PROJECT_ENDPOINT = "your_project_endpoint"

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

# Run a responses API call
response = openai.responses.create(
    model="gpt-5-mini",  # supports all Foundry direct models
    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.services.ai.azure.com/api/projects/project_name"
FOUNDRY_PROJECT_ENDPOINT = "your_project_endpoint"
FOUNDRY_AGENT_NAME = "your-agent-name"

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

# Create an agent with a model and instructions
agent = project.agents.create_version(
    agent_name=FOUNDRY_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.services.ai.azure.com/api/projects/project_name"
FOUNDRY_PROJECT_ENDPOINT = "your_project_endpoint"
FOUNDRY_AGENT_NAME = "your_agent_name"

# Create project and openai clients to call Foundry API
project = AIProjectClient(
    endpoint=FOUNDRY_PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
# Get an OpenAI client pre-bound to the specified agent
openai = project.get_openai_client(agent_name=FOUNDRY_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