Conceptos de agentes

Un agente de Agent Framework combina una abstracción de agente, un modelo o una conexión de agente remoto, instrucciones, herramientas, middleware, proveedores de contexto y estado de sesión detrás de una interfaz de ejecución coherente.

Tiempo de ejecución y ejecución

• La ejecución de agentes explica las ejecuciones normales y de streaming, las opciones de ejecución, las respuestas, los mensajes y el contenido.
• La canalización del agente explica cómo participan en una ejecución el middleware, los proveedores de contexto, la invocación de modelos y las herramientas.

Tipos de agente

• Los agentes personalizados explican la interfaz del agente común y cuándo implementar un agente directamente.
• Los proveedores de modelos conectan los agentes propiedad de la aplicación a los servicios de inferencia.
• Los servicios del agente se conectan a agentes remotos administrados o respaldados por protocolos.

Agentes de cliente de chat

Los agentes de cliente de chat son agentes propiedad de la aplicación respaldados por un cliente de inferencia de modelos. Admiten herramientas de funciones, conversaciones multiturno, herramientas hospedadas por el proveedor, donde están disponibles, salidas estructuradas, streaming, middleware y historial de conversaciones locales o administradas por el servicio.

Cualquier cliente de inferencia que implemente Microsoft.Extensions.AI.IChatClient puede hacer una copia de seguridad de ChatClientAgent:

using Microsoft.Agents.AI;

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

Todas las implementaciones de agente comparten la AIAgent abstracción, por lo que el código de aplicación y las orquestaciones pueden trabajar con agentes de cliente de chat, agentes personalizados y servidores proxy de agente remoto a través de una interfaz.

Para conocer las funcionalidades del proveedor, la compatibilidad con el historial de conversaciones y la selección de puntos de conexión del SDK, consulte Proveedores de modelos.

Cree un estándar Agent a partir de cualquier cliente que implemente SupportsChatGetResponse:

from agent_framework import Agent

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

La misma Agent interfaz funciona en los proveedores de modelos admitidos. En su lugar, los tipos de agente directo, como FoundryAgent, A2AAgentGitHubCopilotAgent, y ClaudeAgent se conectan a los entornos de ejecución administrados o remotos del agente.

Para ver los clientes de inferencia disponibles, consulte Proveedores de modelos.

Los paquetes de proveedor de modelos de Go construyen el tipo estándar *agent.Agent a través de constructores específicos del proveedor. Esto proporciona a código de aplicación una ejecución coherente, una sesión, una herramienta, un middleware y una interfaz de streaming, mientras que cada proveedor posee la inicialización del cliente.

Para constructores e importar rutas de acceso, consulte Proveedores de modelos.

Conversaciones y memoria

Los conceptos de conversación abarcan sesiones, proveedores de contexto, almacenamiento, compactación y el proveedor de memoria integrado del historial de chat.

Middleware

Los conceptos de middleware abarcan la definición, el ámbito, la ordenación, el estado compartido, el contexto en tiempo de ejecución, la terminación, los errores y las invalidaciones de resultados.

Safety

La seguridad del agente describe los patrones de diseño para restringir el comportamiento del agente y reducir el riesgo operativo. La aplicación de seguridad con FIDES sigue siendo una funcionalidad del agente.

Pasos siguientes

Obtenga información sobre cómo ejecutar agentes