Freigeben über


Microsoft Foundry – Schnellstart

In dieser Schnellstartanleitung beginnen Sie mit der Verwendung von Modellen und Agents in Foundry.

Sie werden:

  • Generieren einer Antwort aus einem Modell
  • Erstellen eines Agents mit einer definierten Eingabeaufforderung
  • Eine mehrstufige Unterhaltung mit dem Agenten führen

Voraussetzungen

Festlegen von Umgebungsvariablen und Abrufen des Codes

Speichern Sie Ihren Projektendpunkt als Umgebungsvariable. Legen Sie diese Werte auch für die Verwendung in Ihren Skripts fest.

Python und JavaScript

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

C# und Java

ProjectEndpoint = <endpoint copied from welcome screen>
AgentName = "MyAgent"

Folgen Sie der Anleitung unten oder holen Sie sich den Code:

Melden Sie sich mit dem BEFEHL CLI az login an, um sich zu authentifizieren, bevor Sie Ihre Python-Skripts ausführen.

Installieren und Authentifizieren

Stellen Sie sicher, dass Sie die richtige Version der Pakete installieren, wie hier gezeigt.

  1. Installieren Sie die aktuelle Version von azure-ai-projects. Diese Version verwendet die neue Foundry-Projekte-API.

    pip install azure-ai-projects>=2.0.0
    
  2. Melden Sie sich mit dem BEFEHL CLI az login an, um sich zu authentifizieren, bevor Sie Ihre Python-Skripts ausführen.

Tipp

Code verwendet Azure AI Projects 2.x und ist mit Azure AI Projects 1.x nicht kompatibel. Siehe die Foundry (klassische) Dokumentation für die Azure AI-Projekte Version 1.x.

Chatten mit einem Modell

Die Interaktion mit einem Modell ist der grundlegende Baustein von KI-Anwendungen. Senden Sie eine Eingabe, und empfangen Sie eine Antwort vom Modell:

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"

# 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="gpt-5-mini",  # supports all Foundry direct models
    input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")

Nach dem Ausführen des Codes wird eine modellgenerierte Antwort in der Konsole angezeigt (z. B. ein kurzes Gedicht oder eine Antwort auf Ihre Eingabeaufforderung). Dadurch wird bestätigt, dass Der Projektendpunkt, die Authentifizierung und die Modellbereitstellung ordnungsgemäß funktionieren.

Tipp

Code verwendet Azure AI Projects 2.x und ist mit Azure AI Projects 1.x nicht kompatibel. Siehe die Foundry (klassische) Dokumentation für die Azure AI-Projekte Version 1.x.

Einen Agent erstellen

Erstellen Sie einen Agent mit Ihrem bereitgestellten Modell.

Ein Agent definiert das Kernverhalten. Nach der Erstellung stellt sie konsistente Antworten in Benutzerinteraktionen sicher, ohne jedes Mal Anweisungen wiederholen zu müssen. Sie können Agents jederzeit aktualisieren oder löschen.

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

Die Ausgabe bestätigt, dass der Agent erstellt wurde. Bei den SDK-Registerkarten werden der Agentenname und die Agenten-ID in der Konsole angezeigt.

Tipp

Code verwendet Azure AI Projects 2.x und ist mit Azure AI Projects 1.x nicht kompatibel. Siehe die Foundry (klassische) Dokumentation für die Azure AI-Projekte Version 1.x.

Chatten mit einem Agent

Verwenden Sie den zuvor erstellten Agent namens "MyAgent", um zu interagieren, indem Sie eine Frage und eine zugehörige Nachverfolgung stellen. Die Konversation behält den Verlauf dieser Interaktionen bei.

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=FOUNDRY_PROJECT_ENDPOINT,
    credential=DefaultAzureCredential(),
)
openai = project.get_openai_client()

# 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,
    extra_body={"agent_reference": {"name": FOUNDRY_AGENT_NAME, "type": "agent_reference"}},
    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,
    extra_body={"agent_reference": {"name": FOUNDRY_AGENT_NAME, "type": "agent_reference"}},
    input="And what is the capital city?",
)
print(response.output_text)

Sie sehen die Antworten des Agents auf beide Eingabeaufforderungen. Die Folgeantwort zeigt, dass der Agent den Gesprächsverlauf über mehrere Dialogschritte hinweg beibehält.

Tipp

Code verwendet Azure AI Projects 2.x und ist mit Azure AI Projects 1.x nicht kompatibel. Siehe die Foundry (klassische) Dokumentation für die Azure AI-Projekte Version 1.x.

Bereinigen von Ressourcen

Wenn Sie keine der von Ihnen erstellten Ressourcen mehr benötigen, löschen Sie die dem Projekt zugeordnete Ressourcengruppe.

  • Wählen Sie im portal Azure die Ressourcengruppe aus, und wählen Sie dann Delete aus. Vergewissern Sie sich, dass Sie die Ressourcengruppe löschen möchten.

Nächster Schritt