Conceitos de agentes

Um agente Agent Framework combina uma abstração de agente, uma ligação de modelo ou agente remoto, instruções, ferramentas, middleware, fornecedores de contexto e estado de sessão por detrás de 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 personalizados explica a interface comum dos agentes e quando implementar um agente diretamente.
• Os fornecedores de modelos ligam agentes pertencentes à aplicação a serviços de inferência.
• Os serviços de agente ligam-se a agentes remotos geridos ou apoiados por protocolo.

Agentes cliente de chat

Os agentes chat-client são agentes propriedade da aplicação apoiados por um cliente de inferência de modelo. Suportam ferramentas funcionais, conversas com múltiplas turnos, ferramentas alojadas por fornecedores sempre que disponíveis, saídas estruturadas, streaming, middleware e histórico de conversas local ou gerido por serviços.

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 conectem-se a runtimes de agentes geridos ou remotos em vez disso.

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 aplicação da segurança com o FIDES mantém-se uma capacidade de agente.

Passos seguintes

Aprenda a gerir agentes