mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
32711cfa95
* feat: Define Workflow and Executor APIs * feat: Define IExecutionContext and Events * feat: Simple Workflow Demos * refactor: Move Workflows classes to separate assembly * feat: Move FanOut/In to LowLevel API with new semantics * feat: Implement Local Execution * refactor: Assembly name .Workflow => .Workflows * feat: Enable Default Message Handling * also lifts Bind in MessageHandlerInfo to better be able to direclty invoke handlers (for AOT, later) * feat: Implement StreamingHandle APIs This allows the user to respond to WorkflowEvents with external messages, enabling HIL. * feat: Add checks for duplicate edges and chain cycles * feat: Add built-in WorkflowEvents * refactor: Pull classes into own files * refactor: Simplify Disposal pattern in Executor * refactor: Break EdgeRunner file into per-type files * refactor: Use Throw.IfNull() * refactor: Remove AddLoop() Per https://github.com/microsoft/agent-framework/pull/272#discussion_r2241739079 we decided this was not very useful. * refactor: Normalize use of ValueTask * fix: Build Break from removing .AddLoop * refactor: Explicit routing and RouteBuilder Split out reflection from MessageRouter implemention into build phase, enabling AOT compilation to drive RouteBuilding without reflection. * test: Add Reflection/Invocation tests * fix: Terminate on Completion event * refactor: Update public API surface * feat: Add support for external requests * feat: Support hosting AIAgent instances in Workflows * fix: Fix routing to go through Executor.ExecuteAsync * test: Update samples for "must SendMessage" semantics * Add invoking samples to unit tests to avoid future breaks * fix: ExternalRequest should block Workflow completion * feat: Normalize API surface against Python * Also adds xmldoc to all public APIs * refactor: Normalize UnitTest and Sample namespaces * fix: Formatting * refactor: Normalize project/folder names * feat: Remove DynamicCodeExecution from ValueTaskTypeErasure * fix: Fix ILTrim warnings * docs: Add missing docs and fix typos * feat: Hosted Agents should report Run events * fix: Fix type propagation for ILTrim changes * refactor: Simplify DynamicallyAccessedMembers annotations * sample: Use static-Type construction of InputPort * feat: Support non-Streaming Run Mode * test: Add test for non-streaming execution * refactor: Remove unused types * refactor: Simplify Event and EdgeData type hierarchies * feat: Add Switch (=Conditional Edge Group) control flow * feat: Make .NET AutoSend the MessageHandler result * feat: Implement State APIs * refactor: Simplify public namespaces and code organization * refactor: Reconcile .NET and Python names --------- Co-authored-by: Chris <66376200+crickman@users.noreply.github.com>
132 lines
3.7 KiB
C#
132 lines
3.7 KiB
C#
// Copyright (c) Microsoft. All rights reserved.
|
|
|
|
using System;
|
|
using System.Threading.Tasks;
|
|
using Microsoft.Agents.Workflows.Execution;
|
|
using Microsoft.Agents.Workflows.Reflection;
|
|
using Moq;
|
|
|
|
namespace Microsoft.Agents.Workflows.UnitTests;
|
|
|
|
public class BaseTestExecutor<TActual> : ReflectingExecutor<TActual> where TActual : ReflectingExecutor<TActual>
|
|
{
|
|
protected void OnInvokedHandler()
|
|
{
|
|
this.InvokedHandler = true;
|
|
}
|
|
|
|
public bool InvokedHandler
|
|
{
|
|
get;
|
|
private set;
|
|
} = false;
|
|
}
|
|
|
|
public class DefaultHandler : BaseTestExecutor<DefaultHandler>, IMessageHandler<object>
|
|
{
|
|
public ValueTask HandleAsync(object message, IWorkflowContext context)
|
|
{
|
|
this.OnInvokedHandler();
|
|
return this.Handler(message, context);
|
|
}
|
|
|
|
public Func<object, IWorkflowContext, ValueTask> Handler
|
|
{
|
|
get;
|
|
set;
|
|
} = (message, context) => default;
|
|
}
|
|
|
|
public class TypedHandler<TInput> : BaseTestExecutor<TypedHandler<TInput>>, IMessageHandler<TInput>
|
|
{
|
|
public ValueTask HandleAsync(TInput message, IWorkflowContext context)
|
|
{
|
|
this.OnInvokedHandler();
|
|
return this.Handler(message, context);
|
|
}
|
|
|
|
public Func<TInput, IWorkflowContext, ValueTask> Handler
|
|
{
|
|
get;
|
|
set;
|
|
} = (message, context) => default;
|
|
}
|
|
|
|
public class TypedHandlerWithOutput<TInput, TResult> : BaseTestExecutor<TypedHandlerWithOutput<TInput, TResult>>, IMessageHandler<TInput, TResult>
|
|
{
|
|
public ValueTask<TResult> HandleAsync(TInput message, IWorkflowContext context)
|
|
{
|
|
this.OnInvokedHandler();
|
|
return this.Handler(message, context);
|
|
}
|
|
public Func<TInput, IWorkflowContext, ValueTask<TResult>> Handler
|
|
{
|
|
get;
|
|
set;
|
|
} = (message, context) => default;
|
|
}
|
|
|
|
public class RoutingReflectionTests
|
|
{
|
|
private async ValueTask<CallResult?> RunTestReflectAndRouteMessageAsync<TInput, TE>(BaseTestExecutor<TE> executor, TInput? input = default) where TInput : new() where TE : ReflectingExecutor<TE>
|
|
{
|
|
MessageRouter router = executor.Router;
|
|
|
|
Assert.NotNull(router);
|
|
input ??= new();
|
|
Assert.True(router.CanHandle(input.GetType()));
|
|
Assert.True(router.CanHandle(input));
|
|
|
|
CallResult? result = await router.RouteMessageAsync(input, Mock.Of<IWorkflowContext>());
|
|
|
|
Assert.True(executor.InvokedHandler);
|
|
|
|
return result;
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Test_ReflectAndExecute_DefaultHandlerAsync()
|
|
{
|
|
DefaultHandler executor = new();
|
|
|
|
CallResult? result = await this.RunTestReflectAndRouteMessageAsync<object, DefaultHandler>(executor);
|
|
|
|
Assert.NotNull(result);
|
|
Assert.True(result.IsSuccess);
|
|
Assert.True(result.IsVoid);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Test_ReflectAndExecute_HandlerReturnsVoidAsync()
|
|
{
|
|
TypedHandler<int> executor = new();
|
|
|
|
CallResult? result = await this.RunTestReflectAndRouteMessageAsync<object, TypedHandler<int>>(executor, 3);
|
|
|
|
Assert.NotNull(result);
|
|
Assert.True(result.IsSuccess);
|
|
Assert.True(result.IsVoid);
|
|
}
|
|
|
|
[Fact]
|
|
public async Task Test_ReflectAndExecute_HandlerReturnsValueAsync()
|
|
{
|
|
TypedHandlerWithOutput<int, string> executor = new()
|
|
{
|
|
Handler = (message, context) =>
|
|
{
|
|
return new ValueTask<string>($"{message}");
|
|
}
|
|
};
|
|
|
|
const string Expected = "3";
|
|
CallResult? result = await this.RunTestReflectAndRouteMessageAsync<object, TypedHandlerWithOutput<int, string>>(executor, int.Parse(Expected));
|
|
|
|
Assert.NotNull(result);
|
|
Assert.True(result.IsSuccess);
|
|
Assert.False(result.IsVoid);
|
|
|
|
Assert.Equal(Expected, result.Result);
|
|
}
|
|
}
|