Conceitos sobre agentes

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

Runtime e execução

  • Os agentes em execução explicam execuções regulares e de 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.

Tipos de agente

Agentes de chat-cliente

Os agentes de chat-client são agentes de propriedade do aplicativo apoiados por um cliente de inferência de modelo. Eles dão suporte a ferramentas de funções, conversas de vários turnos, 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 agente compartilham a abstração, de modo que o AIAgent código do aplicativo e as orquestrações possam funcionar com agentes de chat-client, agentes personalizados e proxies de agente remoto por meio de uma interface.

Para recursos de provedor, suporte ao histórico de conversas e seleção de ponto de extremidade do SDK, consulte provedores de modelo.

Crie um padrão Agent 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, A2AAgente GitHubCopilotAgentClaudeAgent conectar-se a runtimes de agente gerenciado ou remoto em vez disso.

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

Os pacotes go model-provider constrói o tipo padrão *agent.Agent por meio de construtores específicos do 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 uma funcionalidade do agente.

Próximas Etapas