Dapr

O bloco de construção Dapr Conversation roteia a inferência do modelo por meio de um sidecar da Dapr e expõe um IChatClient que pode apoiar um agente .NET do Agent Framework. O provedor de modelo e as credenciais são configurados no componente Dapr Conversation em vez de diretamente no processo do agente.

Prerequisites

• .NET 10 ou versão posterior.
• Docker e a CLI do Dapr.
• Um componente Conversation do Dapr configurado, como um componente baseado em Ollama.

Instalar os pacotes

dotnet add package Dapr.AI.Microsoft.Extensions
dotnet add package Microsoft.Agents.AI --prerelease

Configuration

DAPR_GRPC_ENDPOINT="http://localhost:3501"

DAPR_GRPC_ENDPOINT é opcional e usa http://localhost:3501 como padrão. Defina ConversationComponentName no código do aplicativo com o nome do componente Dapr Conversation, como ollama.

Criar um agente com backup de Dapr

Configure o endpoint do sidecar do Dapr e o componente Conversation por meio da injeção de dependências, resolva o IChatClient e converta-o em um agente.

// the sidecar (see this sample's README). Override it with the DAPR_GRPC_ENDPOINT environment
// variable if you run the sidecar on a different port.
var daprGrpcEndpoint = Environment.GetEnvironmentVariable("DAPR_GRPC_ENDPOINT") ?? "http://localhost:3501";

// Register the Dapr Conversation client with dependency injection.
var app = Host.CreateDefaultBuilder()
    .ConfigureServices(services =>
    {
        // Configure the gRPC endpoint for the Dapr sidecar.
        services.AddDaprConversationClient((_, builder) => builder.UseGrpcEndpoint(daprGrpcEndpoint));
        // Provide the name of the Conversation component loaded in the sidecar to use.
        services.AddDaprChatClient(opt => opt.ConversationComponentName = "ollama");
    }).Build();

// Get an instance of the Dapr chat client from the dependency injection container.
using var scope = app.Services.CreateScope();
var daprChatClient = scope.ServiceProvider.GetRequiredService<IChatClient>();

// Use this chat client to construct an AIAgent.
AIAgent agent = daprChatClient.AsAIAgent(instructions: "You are good at telling jokes.", name: "Joker");

// Invoke the agent and output the text result.
Console.WriteLine(await agent.RunAsync("Tell me a joke about a pirate."));

As capacidades do provedor dependem do componente Dapr Conversation e do modelo subjacente.

Tools

O suporte à ferramenta é herdado do componente e do modelo configurados do Dapr Conversation.

Próximas Etapas