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.

Pré-requisitos

• .NET 10 ou posteriores.
• Docker e a CLI do Dapr.
• Um componente configurado da Conversa dapr, como um componente com backup de 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 o nome do componente Dapr Conversation, como ollama.

Criar um agente com backup de Dapr

Configure o ponto de extremidade do sidecar da Dapr e o componente conversation por meio da injeção de dependência, resolva e converta-o IChatClientem 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."));

Os recursos do provedor dependem do componente Dapr Conversation e do modelo por trás dele.

Tools

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

Tool	Status	Notes
Ferramentas de Funções	Variações	Requer suporte de chamada de função do componente e modelo configurados.
Aprovação da ferramenta	Variações	Disponível quando o modelo produz chamadas de ferramenta de função.
Ferramentas hospedadas pelo provedor	❌	O Dapr não adiciona uma superfície de ferramenta hospedada do Agent Framework separada.
Ferramentas MCP locais	✅	É executado no processo do aplicativo.

Próximas Etapas 

Visão geral dos Provedores de Modelos