Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este documento se proporciona una visión detallada del sistema eventos de flujos de trabajo en Microsoft Agent Framework.
Información general
Hay eventos integrados que proporcionan observabilidad en la ejecución del flujo de trabajo.
Tipos de eventos integrados
// Workflow lifecycle events
WorkflowStartedEvent // Workflow execution begins
WorkflowOutputEvent // Workflow outputs data
WorkflowErrorEvent // Workflow encounters an error
WorkflowWarningEvent // Workflow encountered a warning
// Executor events
ExecutorInvokedEvent // Executor starts processing
ExecutorCompletedEvent // Executor finishes processing
ExecutorFailedEvent // Executor encounters an error
AgentRunResponseEvent // An agent run produces output
AgentRunUpdateEvent // An agent run produces a streaming update
// Superstep events
SuperStepStartedEvent // Superstep begins
SuperStepCompletedEvent // Superstep completes
// Request events
RequestInfoEvent // A request is issued
# Workflow lifecycle events
WorkflowStartedEvent # Workflow execution begins
WorkflowOutputEvent # Workflow produces an output
WorkflowErrorEvent # Workflow encounters an error
WorkflowWarningEvent # Workflow encountered a warning
# Executor events
ExecutorInvokedEvent # Executor starts processing
ExecutorCompletedEvent # Executor finishes processing
ExecutorFailedEvent # Executor encounters an error
AgentRunEvent # An agent run produces output
AgentRunUpdateEvent # An agent run produces a streaming update
# Superstep events
SuperStepStartedEvent # Superstep begins
SuperStepCompletedEvent # Superstep completes
# Request events
RequestInfoEvent # A request is issued
Consumo de eventos
using Microsoft.Agents.AI.Workflows;
await foreach (WorkflowEvent evt in run.WatchStreamAsync())
{
switch (evt)
{
case ExecutorInvokedEvent invoke:
Console.WriteLine($"Starting {invoke.ExecutorId}");
break;
case ExecutorCompletedEvent complete:
Console.WriteLine($"Completed {complete.ExecutorId}: {complete.Data}");
break;
case WorkflowOutputEvent output:
Console.WriteLine($"Workflow output: {output.Data}");
return;
case WorkflowErrorEvent error:
Console.WriteLine($"Workflow error: {error.Exception}");
return;
}
}
from agent_framework import (
ExecutorCompleteEvent,
ExecutorInvokeEvent,
WorkflowOutputEvent,
WorkflowErrorEvent,
)
async for event in workflow.run_stream(input_message):
match event:
case ExecutorInvokeEvent() as invoke:
print(f"Starting {invoke.executor_id}")
case ExecutorCompleteEvent() as complete:
print(f"Completed {complete.executor_id}: {complete.data}")
case WorkflowOutputEvent() as output:
print(f"Workflow produced output: {output.data}")
return
case WorkflowErrorEvent() as error:
print(f"Workflow error: {error.exception}")
return
Eventos personalizados
Los usuarios pueden definir y emitir eventos personalizados durante la ejecución del flujo de trabajo para mejorar la observabilidad.
using Microsoft.Agents.AI.Workflows;
using Microsoft.Agents.AI.Workflows.Reflection;
internal sealed class CustomEvent(string message) : WorkflowEvent(message) { }
internal sealed class CustomExecutor() : ReflectingExecutor<CustomExecutor>("CustomExecutor"), IMessageHandler<string>
{
public async ValueTask HandleAsync(string message, IWorkflowContext context)
{
await context.AddEventAsync(new CustomEvent($"Processing message: {message}"));
// Executor logic...
}
}
from agent_framework import (
handler,
Executor,
WorkflowContext,
WorkflowEvent,
)
class CustomEvent(WorkflowEvent):
def __init__(self, message: str):
super().__init__(message)
class CustomExecutor(Executor):
@handler
async def handle(self, message: str, ctx: WorkflowContext[str]) -> None:
await ctx.add_event(CustomEvent(f"Processing message: {message}"))
# Executor logic...
Pasos siguientes
- Aprenda a usar agentes en flujos de trabajo para crear flujos de trabajo inteligentes.
- Aprenda a usar flujos de trabajo como agentes.
- Obtenga información sobre cómo controlar solicitudes y respuestas en flujos de trabajo.
- Aprenda a administrar el estado en flujos de trabajo.
- Obtenga información sobre cómo crear puntos de control y reanudarlos a partir de ellos.
- Aprenda a supervisar flujos de trabajo.
- Obtenga información sobre el aislamiento de estado en los flujos de trabajo.
- Aprenda a visualizar flujos de trabajo.