Skapa värdbaserade agentarbetsflöden i Microsoft Foundry Toolkit för Visual Studio Code-tillägget

• Python 3,13 eller senare.

• .NET 10 SDK eller senare.

1. Skapa en virtuell miljö.

    python -m venv .venv
   

2. Aktivera den virtuella miljön.

   # PowerShell
   ./.venv/Scripts/Activate.ps1
   
   # Windows cmd
   .venv\Scripts\activate.bat
   
   # Unix/MacOS
   source .venv/bin/activate
   

3. Installera de paket som krävs:

   pip install -r requirements.txt
   

1. Gå till projektkatalogen och kör det här kommandot för att hämta nödvändiga NuGet-paket:

   dotnet restore
   

Exempelarbetsflödesprojektet skapar en .env-fil med nödvändiga miljövariabler. Skapa eller uppdatera .env-filen med dina Foundry-autentiseringsuppgifter:

FOUNDRY_PROJECT_ENDPOINT=https://<your-resource-name>.services.ai.azure.com/api/projects/<your-project-name>

FOUNDRY_MODEL_NAME=<your-model-deployment-name>

Autentisera din värdbaserade agent

Exemplet med den värdbaserade agenten autentiserar sig med DefaultAzureCredential. Konfigurera utvecklingsmiljön för att ange autentiseringsuppgifter via en av de källor som stöds, till exempel:

• Azure CLI (az login)
• Visual Studio Code kontoinloggning
• Visual Studio kontoinloggning
• Miljövariabler för tjänstens huvudnamn (AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET)

Bekräfta autentiseringen lokalt genom att köra kommandona Azure CLI az account show eller az account get-access-token innan du kör exemplet.

Du kan köra den värdbaserade agenten i interaktivt läge eller containerläge.

Kör din värdagent i Agentinspektören

Tryck på F5 för att starta den lokala HTTP-servern med felsökning aktiverat. Foundry Toolkit Agent Inspector öppnas för interaktiv testning och du kan ange brytpunkter i koden.

Så här kör du servern utan felsökning:

python main.py

Agenten lyssnar på http://localhost:8088/. Skicka en testprompt med curl (eller någon HTTP-klient):

curl -sS -H "Content-Type: application/json" -X POST http://localhost:8088/responses \
    -d '{"input": "Write a haiku about deploying cloud applications.", "stream": false}'

Exempelarbetsflödesprojektet skapar en .env-fil med nödvändiga miljövariabler. Skapa eller uppdatera .env-filen med dina Foundry-autentiseringsuppgifter:

1. Konfigurera miljövariabler baserat på ditt operativsystem:

   • Windows (PowerShell)
   • Windows (kommandotolk)
   • macOS/Linux (Bash)

   $env:FOUNDRY_PROJECT_ENDPOINT="https://<your-resource-name>.services.ai.azure.com/api/projects/<your-project-name>"
   $env:FOUNDRY_MODEL_NAME="your-deployment-name"
   

Autentisera din värdbaserade agent

Exemplet med den värdbaserade agenten autentiserar sig med DefaultAzureCredential. Konfigurera utvecklingsmiljön för att ange autentiseringsuppgifter via en av de källor som stöds, till exempel:

• Azure CLI (az login)
• Visual Studio Code kontoinloggning
• Visual Studio kontoinloggning
• Miljövariabler för tjänstens huvudnamn (AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET)

Bekräfta autentiseringen lokalt genom att köra kommandona Azure CLI az account show eller az account get-access-token innan du kör exemplet.

Du kan köra den värdbaserade agenten i interaktivt läge eller containerläge.

Kör din värdbaserade agent i interaktivt läge

Kör den värdbaserade agenten direkt för utveckling och testning:

dotnet restore
dotnet build
dotnet run

Kör din värdbaserade agent i containerläge

Så här kör du agenten i containerläge:

1. Öppna kommandopaletten Visual Studio Code och kör kommandot Foundry Toolkit: Open Container Agent Playground Locally.
2. Använd följande kommando för att initiera den containerbaserade värdbaserade agenten.

   dotnet restore
   dotnet build
   dotnet run
   

3. Skicka en begäran till agenten via playground-gränssnittet. Ange till exempel en uppmaning som: "Skapa en slogan för en ny elektrisk SUV som är prisvärd och rolig att köra."
4. Granska agentens svar i playground-gränssnittet.

Visualisera körning av värdbaserade agentarbetsflöden

Tillägget Microsoft Foundry Toolkit for Visual Studio Code innehåller ett realtidskörningsdiagram som visar hur agenter i arbetsflödet interagerar och samarbetar. Aktivera observerbarhet i projektet för att använda den här visualiseringen.

Lägg till följande referens till csproj-filen:

<ItemGroup>
    <PackageReference Include="OpenTelemetry" Version="1.12.0" />
    <PackageReference Include="OpenTelemetry.Exporter.Console" Version="1.12.0" />
    <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.12.0" />
    <PackageReference Include="System.Diagnostics.DiagnosticSource" Version="9.0.10" />
</ItemGroup>

Uppdatera programmet så att det innehåller följande kodfragment:

using System.Diagnostics;
using OpenTelemetry;
using OpenTelemetry.Logs;
using OpenTelemetry.Metrics;
using OpenTelemetry.Resources;
using OpenTelemetry.Trace;

var otlpEndpoint =
    Environment.GetEnvironmentVariable("OTLP_ENDPOINT") ?? "http://localhost:4319";

var resourceBuilder = OpenTelemetry
    .Resources.ResourceBuilder.CreateDefault()
    .AddService("WorkflowSample");

var s_tracerProvider = OpenTelemetry
    .Sdk.CreateTracerProviderBuilder()
    .SetResourceBuilder(resourceBuilder)
    .AddSource("Microsoft.Agents.AI.*") // All agent framework sources
    .SetSampler(new AlwaysOnSampler()) // Ensure all traces are sampled
    .AddOtlpExporter(options =>
    {
        options.Endpoint = new Uri(otlpEndpoint);
        options.Protocol = OpenTelemetry.Exporter.OtlpExportProtocol.Grpc;
    })
    .Build();

Övervaka och visualisera ditt värdbaserade agentarbetsflöde

Så här övervakar och visualiserar du arbetsflödet för värdbaserad agent i realtid:

1. Öppna kommandopaletten (Ctrl+Skift+P).

2. Kör det här kommandot: >Foundry Toolkit: Open Visualizer for Hosted Agents.

En ny flik öppnas i VS Code för att visa körningsdiagrammet. Visualiseringen uppdateras automatiskt när arbetsflödet fortskrider för att visa flödet mellan agenter och deras interaktioner.

Portkonflikter

För portkonflikter kan du ändra visualiseringsporten genom att ange den i Microsoft Foundry Toolkit för Visual Studio Code tilläggsinställningar. Gör det genom att följa dessa steg:

1. I det vänstra sidofältet i VS Code väljer du kugghjulsikonen för att öppna inställningsmenyn.
2. Välj Extensions>Microsoft Foundry Configuration.
3. Leta upp inställningen Hosted Agent Visualization Port och ändra den till ett tillgängligt portnummer.
4. Starta om VS Code för att tillämpa ändringarna.

Ändra port i kod

För eventuella portkonflikter ändrar du visualiseringsporten genom att FOUNDRY_OTLP_PORT ange miljövariabeln. Uppdatera OTLP-slutpunkten i programmet i enlighet med detta.

Om du till exempel vill ändra porten till 4318 använder du det här kommandot:

  $env:FOUNDRY_OTLP_PORT="4318"

I programmet uppdaterar du OTLP-slutpunkten så att den använder det nya portnumret:

var otlpEndpoint =
    Environment.GetEnvironmentVariable("OTLP_ENDPOINT") ?? "http://localhost:4318";

1. Öppna Kommandopaletten och välj Foundry Toolkit: Deploy Hosted Agent. En webbvy för distribution öppnas.
2. För "Distributionsmetod" väljer du Kod eller Container.
3. Om du distribuerar med "Code" för "Paketläge" väljer du Fjärr eller Lokal.
4. Om du distribuerar med "Container" väljer du antingen Standard-ACR, Anpassad ACR eller Kund-ACR-avbildning.
5. Agentnamnet bör fyllas i automatiskt.
6. Välj knappen "Nästa".
7. Sidan "Granska och distribuera" ska fyllas i automatiskt i sin helhet.
8. Välj knappen "Distribuera".
9. Öppna kommandopaletten Visual Studio Code och kör kommandot Foundry Toolkit: Deploy Hosted Agent.

1. Öppna kommandopaletten Visual Studio Code och kör kommandot Foundry Toolkit: Deploy Hosted Agent.
2. För "Distributionsmetod" väljer du Kod eller Container.
3. Om du distribuerar med "Code" för "Paketläge" väljer du Fjärr eller Lokal.
4. Om du distribuerar med "Container" väljer du antingen Standard-ACR, Anpassad ACR eller Kund-ACR-avbildning.
5. Agentnamnet bör fyllas i automatiskt.
6. Välj knappen "Nästa".
7. Sidan "Granska och distribuera" ska fyllas i automatiskt i sin helhet.
8. Välj knappen "Distribuera".