Conceitos sobre agentes

Um agente do Agent Framework combina uma abstração de agente, uma conexão com um modelo ou com um agente remoto, instruções, ferramentas, middleware, provedores de contexto e estado de sessão sob uma interface de execução consistente.

Tempo de execução e execução

• Execução de agentes explica execuções regulares e com streaming, opções de execução, respostas, mensagens e conteúdo.
• O pipeline do agente explica como middleware, provedores de contexto, invocação de modelo e ferramentas participam de uma execução.
• O roteamento de modelos em tempo de execução explica quando uma conversa pode alternar entre modelos ou provedores de inferência sem perder o contexto.

Tipos de agente

• Agentes personalizados explicam a interface do agente comum e quando implementar um agente diretamente.
• Os provedores de modelo conectam agentes de propriedade do aplicativo a serviços de inferência.
• Os serviços de agente se conectam a agentes remotos gerenciados ou com suporte de protocolo.

Agentes cliente de chat

Os agentes cliente de chat são agentes pertencentes ao aplicativo com suporte de um cliente de inferência de modelo. Eles dão suporte a ferramentas de funções, conversas de várias rodadas, ferramentas hospedadas pelo provedor, quando disponíveis, saídas estruturadas, streaming, middleware e histórico de conversa local ou gerenciado pelo serviço.

Qualquer cliente de inferência que implementa Microsoft.Extensions.AI.IChatClient pode fazer backup de um ChatClientAgent:

using Microsoft.Agents.AI;

AIAgent agent = new ChatClientAgent(
    chatClient,
    instructions: "You are a helpful assistant.");

Todas as implementações de agentes compartilham a abstração AIAgent, permitindo que o código da aplicação e as orquestrações funcionem com agentes de clientes de chat, agentes personalizados e proxies de agentes remotos por uma única interface.

Para capacidades dos provedores, suporte ao histórico de conversas e seleção de endpoint do SDK, consulte Provedores de modelo.

Crie um cliente padrão Agent a partir de qualquer cliente que implemente SupportsChatGetResponse:

from agent_framework import Agent

agent = Agent(
    client=client,
    instructions="You are a helpful assistant.",
)

A mesma Agent interface funciona entre provedores de modelo com suporte. Tipos de agente direto, como FoundryAgent, A2AAgent, GitHubCopilotAgent e ClaudeAgent, se conectam a runtimes de agentes gerenciados ou remotos em vez disso.

Para clientes de inferência disponíveis, consulte provedores de modelo.

Os pacotes de provedor de modelo Go constroem o tipo *agent.Agent padrão por meio de construtores específicos de cada provedor. Isso fornece ao código do aplicativo uma execução, sessão, ferramenta, middleware e interface de streaming consistentes, enquanto cada provedor possui a inicialização do cliente.

Para construtores e caminhos de importação, consulte provedores de modelo.

Conversas e memória

Os conceitos de conversa abrangem sessões, provedores de contexto, armazenamento, compactação e o provedor de memória interno de histórico de chat.

Middleware

Os conceitos de middleware abrangem definição, escopo, ordenação, estado compartilhado, contexto de tempo de execução, encerramento, erros e substituições de resultados.

Safety

A segurança do agente descreve padrões de design para restringir o comportamento do agente e reduzir o risco operacional. A imposição de segurança com o FIDES continua sendo um recurso do agente.

Próximas Etapas 

Saiba como executar agentes