Conceitos de agentes

Um agente do Agent Framework combina uma abstração de agente, um modelo ou uma ligação a 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

  • Agentes de execução explica execuções regulares e em streaming, opções de execução, respostas, mensagens e conteúdos.
  • O pipeline de agentes explica como o middleware, os fornecedores de contexto, a invocação de modelos e as ferramentas participam numa execução.

Tipos de agentes

Agentes cliente de chat

Os agentes do cliente de chat são agentes pertencentes à aplicação, suportados por um cliente de inferência de modelo. Suportam ferramentas de função, conversas com múltiplos turnos, ferramentas alojadas pelo fornecedor, quando disponíveis, saídas estruturadas, streaming, middleware e histórico de conversas local ou gerido pelo serviço.

Qualquer cliente de inferência que implemente Microsoft.Extensions.AI.IChatClient pode apoiar um ChatClientAgent:

using Microsoft.Agents.AI;

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

Todas as implementações de agentes partilham a AIAgent abstração, pelo que o código da aplicação e as orquestrações podem funcionar com agentes cliente-chat, agentes personalizados e proxies de agentes remotos através de uma única interface.

Para capacidades de fornecedores, suporte ao histórico de conversas e seleção de endpoints do SDK, consulte Fornecedores de modelo.

Crie um standard 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 os fornecedores de modelos suportados. Tipos de agentes diretos, como FoundryAgent, A2AAgent, GitHubCopilotAgent e ClaudeAgent, ligam-se a ambientes de execução de agentes geridos ou remotos em alternativa.

Para clientes de inferência disponíveis, veja Fornecedores de Modelos.

Os pacotes modelo-fornecedor Go constroem o tipo padrão *agent.Agent através de construtores específicos para cada fornecedor. Isto confere ao código da aplicação uma execução, sessão, ferramenta, middleware e interface de streaming consistentes, enquanto cada fornecedor detém a inicialização do cliente.

Para construtores e caminhos de importação, veja Fornecedores de modelos.

Conversas e memória

Os conceitos de conversa abrangem sessões, fornecedores de contexto, armazenamento, compactação e o fornecedor de memória de histórico de chat incorporado.

Middleware

Os conceitos de middleware abrangem definição, âmbito, ordenação, estado partilhado, contexto em tempo de execução, terminação, erros e sobreposições de resultados.

Safety

A segurança do agente descreve padrões de conceção para restringir o comportamento do agente e reduzir o risco operacional. A imposição de segurança com FIDES continua a ser uma Capacidade do Agente.

Passos seguintes