AzureAIAgent Leitfaden für die Ga-Migration von Foundry

In Semantic Kernel .NET 1.53.1+ müssen .NET- und Python-Entwickler AzureAIAgent die Muster aktualisieren, die sie für die Interaktion mit der Azure AI Foundry als Reaktion auf den Wechsel zu GA verwenden.

GA Foundry-Projekt

• Muss am oder nach dem 19. Mai 2025 erstellt werden
• Verbinden Sie programmgesteuert mithilfe der Endpunkt-URL des Foundry-Projekts .
• Erfordert semantischen Kernel, Version 1.53.1 und höher.
• Basierend auf dem Paket "Azure.AI.Agents.Persistent"

Pre-GA-Gießerei-Projekt

• Wurde vor dem 19. Mai 2025 erstellt
• Verbinden Sie programmgesteuert mithilfe der Verbindungszeichenfolge des Foundry Project .
• Verwenden Sie weiterhin semantische Kernelversionen unter Version 1.53.*
• Basierend auf dem Paket Azure.AI.Projects Version 1.0.0-beta.8

Erstellen eines Clients

Alter Weg

AIProjectClient client = AzureAIAgent.CreateAzureAIClient("<connection string>", new AzureCliCredential());
AgentsClient agentsClient = client.GetAgentsClient();

Neuer Weg

PersistentAgentsClient agentsClient = AzureAIAgent.CreateAgentsClient("<endpoint>", new AzureCliCredential());```

Erstellen eines Agents

Alter Weg

Agent agent = await agentsClient.CreateAgentAsync(...);

Neuer Weg

PersistentAgent agent = await agentsClient.Administration.CreateAgentAsync(

Löschen eines Agents

Alter Weg

await agentsClient.DeleteAgentAsync("<agent id>");

Neuer Weg

await agentsClient.Administration.DeleteAgentAsync("<agent id>");

Hochladen von Dateien

Alter Weg

AgentFile fileInfo = await agentsClient.UploadFileAsync(stream, AgentFilePurpose.Agents, "<file name>");

Neuer Weg

PersistentAgentFileInfo fileInfo = await agentsClient.Files.UploadFileAsync(stream, PersistentAgentFilePurpose.Agents, "<file name>");

Löschen von Dateien

Alter Weg

await agentsClient.DeleteFileAsync("<file id>");

Neuer Weg

await agentsClient.Files.DeleteFileAsync("<file id>");

Erstellen eines VectorStores

Alter Weg

VectorStore fileStore = await agentsClient.CreateVectorStoreAsync(...);

Neuer Weg

PersistentAgentsVectorStore fileStore = await agentsClient.VectorStores.CreateVectorStoreAsync(...);

Löschen eines VectorStores

Alter Weg

await agentsClient.DeleteVectorStoreAsync("<store id>");

Neuer Weg

await agentsClient.VectorStores.DeleteVectorStoreAsync("<store id>");

AzureAIAgent

In Semantic Kernel Python 1.31.0 und höher wurde der AzureAIAgent-Support aktualisiert, um mit der allgemeinen Verfügbarkeit von Azure AI Foundry in Einklang zu stehen. Dieses Update erfordert mehrere Änderungen für Entwickler, die in Foundry-Projekte integriert werden.

project_connection_string und seine Umgebungsvariable AZURE_AI_AGENT_PROJECT_CONNECTION_STRING werden nicht mehr unterstützt. Stattdessen müssen Sie eine endpoint mit der AZURE_AI_AGENT_ENDPOINT Umgebungsvariable konfigurieren. Der Endpunkt befindet sich auf Ihrer Azure Foundry-Projektseite und folgt diesem Format: https://<resource>.services.ai.azure.com/api/projects/<project-name>

Toolbezogene Importe haben sich ebenfalls geändert. Tools, die zuvor aus azure.ai.projects.models importiert wurden, müssen jetzt aus azure.ai.agents.modelsimportiert werden. Informationen zu aktuellen Mustern finden Sie in den aktualisierten AzureAIAgent-Beispielen für erste Schritte oder AzureAIAgent-Konzeptbeispiele .

Folgen Sie den Setupanweisungen in der offiziellen Dokumentation: Azure AI Agents – Schnellstart.

GA Foundry-Projekt

• Muss am oder nach dem 19. Mai 2025 erstellt werden.
• Verbinden Sie programmgesteuert mithilfe der Endpunkt-URL des Foundry-Projekts.
• Erfordert semantischen Kernel, Version 1.31.0 oder höher.
• Verwendet Pakete azure-ai-projects Version 1.0.0b11 oder höher und azure-ai-agents Version 1.0.0 oder höher, installiert über pip install semantic-kernel.

Tipp

Ab Version 1.32.1 des semantischen Kernels sind die für die Verwendung AzureAIAgent erforderlichen Abhängigkeiten in der Standardinstallation enthalten. Sie müssen das azure Zusatz nicht mehr installieren. Die Ausführung von pip install semantic-kernel ist ausreichend.

Pre-GA-Gießerei-Projekt

• Wurde vor dem 19. Mai 2025 erstellt.
• Verwenden Sie die Verbindungszeichenfolge des Foundry-Projekts, um sich programmgesteuert zu verbinden.
• Erfordert semantische Kernelversionen unter 1.31.0.
• Verwendet Paketversion azure-ai-projects 1.0.0b10 oder niedriger.

Aktualisierte Importe für Tools:

Alter Weg

from azure.ai.projects.models import CodeInterpreterTool, FileSearchTool, OpenApiAnonymousAuthDetails, OpenApiTool

Neuer Weg

from azure.ai.agents.models import CodeInterpreterTool, FileSearchTool, OpenApiAnonymousAuthDetails, OpenApiTool

Hochladen von Dateien:

Alter Weg

from azure.ai.projects.models import FilePurpose

file = await client.agents.upload_file_and_poll(file_path="<file-path>", purpose=FilePurpose.AGENTS)

Neuer Weg

from azure.ai.agents.models import FilePurpose

file = await client.agents.files.upload_and_poll(file_path="<file-path>", purpose=FilePurpose.AGENTS)

Löschen von Dateien:

Alter Weg

await client.agents.delete_file(file.id)

Neuer Weg

await client.agents.files.delete(file.id)

Vektorspeicher erstellen:

Alter Weg

from azure.ai.projects.models import VectorStore

vector_store: VectorStore = await client.agents.create_vector_store_and_poll(
    file_ids=[file.id], name="<vector-store-name>"
)

Neuer Weg

from azure.ai.agents.models import VectorStore

vector_store: VectorStore = await client.agents.vector_stores.create_and_poll(
    file_ids=[file.id], name="<vector-store-name>"
)

Löschen von Vektorspeichern:

Alter Weg

from azure.ai.projects.models import VectorStore

await client.agents.delete_vector_store(vector_store.id)

Neuer Weg

from azure.ai.agents.models import VectorStore

await client.agents.vector_stores.delete(vector_store.id)

AzureAIAgent ist derzeit in Java nicht verfügbar.