Rychlý start: Začínáme se sadou Microsoft Foundry SDK

V tomto rychlém průvodci začnete používat modely a agenty v Foundry.

Budete:

  • Vygenerování odpovědi z modelu
  • Vytvoření agenta s definovanou výzvou
  • Vést víceetapovou konverzaci s agentem

Požadavky

  • Model nasazený v Microsoft Foundry Pokud model nemáte, nejprve dokončete Quickstart: Nastavení prostředků Microsoft Foundry.

    Tip

    Nebo přeskočte krok nasazení a zkuste místo toho okamžitý model (Preview). Vytvořte projekt v oblasti USA – západ 3 pro použití modelů okamžitého přístupu. Okamžité modely nemají žádné nasazení, proto použijte název gpt-5-mini modelu všude, kde ukázky požádají o název nasazení.

  • Požadované jazykové runtime, globální nástroje a rozšíření Visual Studio Code, jak je popsáno v Připravení vývojového prostředí.

Získání kódu a nastavení hodnot

Ukázky Python nečtou proměnné prostředí. V každém souboru nahraďte tyto zástupné hodnoty:

  • your_project_endpoint: Koncový bod projektu ve formátu https://<resource-name>.services.ai.azure.com/api/projects/<project-name>.
  • your_agent_name: Název vašeho agenta, například MyAgent.

Ukázky používají nasazení gpt-5-mini, které jste vytvořili v části Nastavení prostředků Microsoft Foundry. Pokud jste model nasadili pod jiným názvem, aktualizujte název modelu v ukázkovém kódu.

Postupujte podle následujících pokynů nebo získejte kód:

Instalace a ověření

Ujistěte se, že jste nainstalovali správnou verzi balíčků, jak je znázorněno zde.

  1. Nainstalujte aktuální verzi souboru azure-ai-projects. Tato verze používá API Foundry projects (new). Ukázky se ověřují pomocí DefaultAzureCredential, který pochází z azure-identity.

    pip install "azure-ai-projects>=2.3.0" azure-identity
    
  2. Před spuštěním skriptů Python se přihlaste pomocí příkazu CLI az login.

Tip

Kód používá Azure AI projekty 2.x a není kompatibilní s Azure AI projekty 1.x. Zobrazit dokumentaci k Foundry (classic) pro verzi Azure AI Projects 1.x.

Chatování s modelem

Interakce s modelem je základní stavební blok aplikací AI. Odeslání vstupu a přijetí odpovědi z modelu:

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}")

Po spuštění kódu se v konzole zobrazí odpověď vygenerovaná modelem (například krátká báseň nebo odpověď na vaši výzvu). Tím potvrdíte, že koncový bod projektu, ověřování a nasazení modelu fungují správně.

Tip

Kód používá Azure AI projekty 2.x a není kompatibilní s Azure AI projekty 1.x. Zobrazit dokumentaci k Foundry (classic) pro verzi Azure AI Projects 1.x.

Vytvoření agenta

Vytvořte agenta pomocí nasazeného modelu.

Agent definuje základní chování. Po vytvoření zajišťuje konzistentní odpovědi v interakcích uživatelů bez opakování pokynů pokaždé. Agenty můžete kdykoli aktualizovat nebo odstranit.

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})")

Výstup potvrzuje, že agent byl vytvořen. Na kartách SDK se zobrazí název a ID agenta vytištěné do konzoly.

Tip

Kód používá Azure AI projekty 2.x a není kompatibilní s Azure AI projekty 1.x. Zobrazit dokumentaci k Foundry (classic) pro verzi Azure AI Projects 1.x.

Chat s agentem

Pomocí dříve vytvořeného agenta s názvem MyAgent můžete interagovat tak, že položíte otázku a související následnou akci. Konverzace udržuje historii napříč těmito interakcemi.

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)

Zobrazí se odpovědi agenta na obě výzvy. Následná odpověď ukazuje, že agent udržuje historii konverzací napříč jednotlivými kroky.

Tip

Kód používá Azure AI projekty 2.x a není kompatibilní s Azure AI projekty 1.x. Zobrazit dokumentaci k Foundry (classic) pro verzi Azure AI Projects 1.x.

Vyčištění prostředků

Pokud už žádné prostředky, které jste vytvořili, nepotřebujete, odstraňte skupinu prostředků přidruženou k vašemu projektu.

  • Na portálu Azure vyberte skupinu prostředků a pak vyberte Delete. Potvrďte, že chcete odstranit skupinu prostředků.

Další krok