agent/agent-framework
1
0
Fork 0
mirror of https://github.com/microsoft/agent-framework.git synced 2026-06-16 21:04:09 +08:00
Code Issues Packages Projects Releases Wiki Activity
894 Commits 249 Branches 163 Tags
feature-python-foundry-agents
Commit Graph

27 Commits

  • .NET: AgentHostExecutor should use agent DisplayName as Executor ID (#1840) 
    * AgentHostExecutor should use agent DisplayName as Executor ID

* Address comments

* Remove unintended changes

* Remove unintended changes

* Fix tests and address comments
    Tao Chen · 2025-11-05 22:16:53 +00:00
    3f835c8118
  • .NET: [BREAKING] .NET: Add Workflow on-Build() Orphan Validation (#1943) 
    * fix: Workflow Validation

* adds orphan validation to workflow builder
* adds tests for workflow validation
* expands on the underlying reasoning why type validation is not supported

* fixup: CodeGen template
    Jacob Alber · 2025-11-05 22:12:27 +00:00
    0bf6d437d8
  • .NET: [BREAKING] refactor: Normalize WorkflowBuilder APIs (#1935) 
    * [BREAKING] refactor: Normalize WorkflowBuilder APIs

* "partitioner" => "assigner"
* normalize ordering so sources always to the left of targets for edges
* normalize parameter ordering so sources and targets are always first arguments
* remove `params` (users should use collection expressions instead)

* refactor: Align name with Python
    Jacob Alber · 2025-11-05 19:50:01 +00:00
    94a5ba3448
  • .NET: Improve fidelity of OpenAI Responses server and add Conversations (#1907) 
    * Improve fidelity of OpenAI Responses server and add Conversations

* Merge

* nit

* Undo prior change

* Undo prior change

* Review feedback

* Review feedback

* Fix test

* Use simpler JsonDocument approach for polymorphic deserialization

* More review feedback

* dotnet format
    Reuben Bond · 2025-11-05 18:46:19 +00:00
    33f84f9ed2
  • .NET: Make sure Workflow activities are as expected (#1903) 
    * Make sure Workflow activities are as expected

* misc

* Copliot comments

* Fix unit tests

* Improve test stability

* Fix unit tests

* Fix formatting
    Tao Chen · 2025-11-05 00:37:31 +00:00
    552f7c781d
  • .NET: [BREAKING] Unify ExecutorIsh and ExecutorRegistration, unify/simplify APIs (#1637) 
    * refactor: Unify ExecutorIsh and ExecutorRegistration => ExecutorBinding

* Switch to more modern Record type-tree for Sum Types
* Unify APIs for getting ExecutorBinding
* Fix an issue where workflows consisting entirely of cross-run shareable executors which are not instance-resettable do not properly clear state when running non-concurrently.

* feat: Simplify function-to-executor pattern

* refactor: Normalize API naming
    Jacob Alber · 2025-11-03 18:20:35 +00:00
    b25b0af49b
  • fix: .NET: Concurrency Support for Orchestrations (#1689) 
    Concurrent run support was recently added to workflows, but Orchestrations did not fully update to support it. A few executors were missing Cross-Run Shareable annotations, and the ConcurrentEnd executor needed to be factory-instantiated.

This also ports the fix for #1613 from #1637, to avoid waiting on that PR.
    Jacob Alber · 2025-10-24 23:18:51 +00:00
    899d8ff775
  • fix: InMemoryCheckpointManager is not JSON serializable (#1639) 
    Checkpointing is used by the WorkflowHostAgent to be able to support resume from a provided thread. When a CheckpointManager is not specified, we use the InMemoryCheckpointManager and serialize its state into the thread's Serialize()ed JsonElement.

At some point InMemoryCheckpointManager became not serializable, breaking this behaviour. This change restores serializability, and adds a test.
    Jacob Alber · 2025-10-23 19:32:52 +00:00
    b2246efa69
  • refactor: [BREAKING] Remove generic Workflow<T> (#1551) 
    Remove input type checking in favour of explicit `.DescribeProtocolAsync()` flow. Also removes `.AsAgentAsync()` as the validation happens at workflow run time. This makes it easier to use Workflows with DI without resorting to async-over-sync.
    Jacob Alber · 2025-10-21 00:13:41 +00:00
    0ef4e739d5
  • .NET: AIAgentHostExecutor to use ToAgentRunResponse (#1439) 
    * AIAgentHostExecutor to use ToAgentRunResponse

* Only run agent in stream mode when emit event is true
    Tao Chen · 2025-10-20 17:50:12 +00:00
    7c1e3db846
  • .NET: [BREAKING] Enable sharing of workflow instances across concurrently executing runs (#1464) 
    * refactor: remove unused internals

* feat: Execution Mode for sharing a workflow among concurrent runs

* feat: Update WorkflowHostAgent to support concurrent execution

* Also update AsAgent APIs to support injecting a CheckpointManager and an IWorkflowExecutionEnvironment

* fix: Make Read logic consistent in DeclarativeWorkflowContext
    Jacob Alber · 2025-10-15 21:34:17 +00:00
    331c750515
  • .NET [WIP]: introduce Hosting extensions for Workflows (#1359) 
    * skeleton

* wip

* rename + fix tests

* implement workflow tests

* fix comments

* Update dotnet/src/Microsoft.Agents.AI.Hosting/HostApplicationBuilderWorkflowExtensions.cs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fixes

* fix worfklow build logic

* rollback + new overload on workflow builder

* address PR comments

* :)

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
    Korolev Dmitry · 2025-10-14 19:44:58 +00:00
    0331331dbc
  • .NET: Mitigation for issue 1315 (#1432) 
    * Adding mitigation for issue 1315, will follow up with long-term plan.

* Apply suggestion from @lokitoth

Co-authored-by: Jacob Alber <jaalber@microsoft.com>

* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Extracting common updates to a helper method.

* Fixing spelling mistake.

* Update per PR feedback.

---------

Co-authored-by: Jacob Alber <jaalber@microsoft.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
    Ben Thomas · 2025-10-13 18:06:58 +00:00
    64b57639b8
  • .NET: fix: Make State Persistence APIs work better with PortableValue (#1367) 
    * fix: Make State Persistence APIs work better with PortableValue

* test: Temporarily disable checking for T=object in ReadStateAsync
    Jacob Alber · 2025-10-09 20:24:55 +00:00
    4cd81fe8e7
  • Fix: Add missing ChatMessage[] handler to ChatProtocolExecutor (#1337) 
    - Added ChatMessage[] handler to ConfigureRoutes to support array dispatch
- Workflow runtime can dispatch messages as either List<ChatMessage> or ChatMessage[]
- Added 10 comprehensive unit tests validating message routing behavior
- Tests ensure functionality and protect against future refactoring (issue #782)
- Updated code comments to reflect exact-type-matching requirement

Fixes issue where raw WorkflowBuilder with AIAgent nodes failed to receive
initial messages due to missing array type handler.
    Christian Glessner · 2025-10-09 10:00:09 +00:00
    8967269d3e
  • .NET: [BREAKING] Propagate CancellationToken into Workflow Executors and message handlers (#1280) 
    * feat: Propagate CancellationToken to Executors

* Also adds cancellation propagation to `Executor`-accessible APIs
* Adds registrators for cancellable handlers to `RouteBuilder`
* [BREAKING]: Adds `CancellationToken` to `IMessageHandler.HandleAsync`

* test: Re-enable Concurrent Orchestration test

* refactor: Delete unused IInputCoordinator

* refactor: Remove superfluous argument qualifications
    Jacob Alber · 2025-10-08 00:28:44 +00:00
    5902bcb10a
  • [BREAKING] .NET: Workflow Off-Thread Execution Mode (#1233) 
    * Updates to async run loop.

* fix: Workflow Onwership can be release by nonowner

* fix: Incorrect handling of blockOnPending in StreamingRun

Depending on whether we are running in streaming on non-streaming mode, we may be using the StreamingRun in different ways. Unfortunately, the only place we can really know what is the actual state of execution is in the RunEventStream implementations.

This resulted in blocking where blocking was unneeded and occasionally not-blocking when blocking was needed.

The fix is to move the logic of handling this blocking into RunEventStream implementations.

* fix: Fix cleanup on error and end run

This ensures we clean up the background resources correctly.

* fix: Ensure we let the run loop proceed when shutting down

* fix: Add timeout for Input Waiting

* fix: Make the samples properly clean up `Run`s and `StreamingRun`s

* fix: Simplify Declarative Workflow Run disposal pattern

* Also fixes missing .Disposal() in Integration tests

---------

Co-authored-by: Ben Thomas <ben.thomas@microsoft.com>
    Jacob Alber · 2025-10-07 01:07:38 +00:00
    7ebe00ec3d
  • feat: Add name and description support to workflows (#1183) 
    Add optional name and description fields to workflows in both Python and .NET implementations, matching the existing agent API pattern.

Python changes:
- Add name/description parameters to WorkflowBuilder.__init__
- Add name/description attributes to Workflow class
- Include name/description in to_dict() serialization
- Add WORKFLOW_NAME and WORKFLOW_DESCRIPTION OTEL attributes
- Add tests in test_serialization.py and test_workflow_observability.py

.NET changes:
- Add Name and Description properties to Workflow and Workflow<T>
- Add WithName() and WithDescription() fluent methods to WorkflowBuilder
- Add WorkflowName and WorkflowDescription OTEL tags
- Add test in WorkflowBuilderSmokeTests.cs

This enables applications like DevUI to display human-readable workflow names (e.g., 'Data Processing Pipeline') instead of auto-generated UUIDs (e.g., 'Workflow 50fdd917').

Fixes: #1181
    Victor Dibia · 2025-10-04 15:20:17 +00:00
    5a7ca13af6
  • .NET: Add support for Subworkflows and many threading fixes (#1066) 
    * feat: Add support for Workflow-as-Executor

* Fixes routing of 'object' compile-typed variables to properly take in type information
* Fixes a concurrency issue in StepTracer

* fix: Make Subworkflow ExternalRequests work properly

* fix: Threading and Concurrency fixes; prep for OffThread Mode

* refactor: Remove dead code around OffStreamRunEventStream

Currently not used, and will be replaced with a rewrite when brought back, so having it in the change is not valuable.

* ci: Work around issues with dotnet-format not properly analyzing the source

* fix: Fix the logic of AsyncCoordinator and AsyncBarrier

* Prevent individual wait cancellations from canceling the entire barrier
* Propagate information about whether the wait was completed or cancelled, and whether any waiters were present when released

* fix: Remove superfluous acces to .Keys in InProcStepTracer

* refactor: Clean up AsyncCoordinator's use of AsyncBarrier
    Jacob Alber · 2025-10-03 17:26:30 +00:00
    32e7ff00b5
  • .NET: Move the AsAIAgent extension methods to the correct class (#1106) 
    * Move the AsAIAgent extension methods to the correct class

* Fix format issue

* Disable unit test, see issue #1109

---------

Co-authored-by: Mark Wallace <markwallace@microsoft.com>
    Mark Wallace · 2025-10-02 12:41:22 +00:00
    b1282254df
  • .NET: Workflow observability (#959) 
    * Add basic Workflow telemetry

* Add sample

* Add source propagation for executor spans

* Fix tests and address comments

* Fix formatting

* Fix declarative unit tests

* Address comments

* Remove Microsoft.Extensions.AI.Agents.EnableTelemetry

* Formatting

* Formatting

* Formatting

* fix solution

* Address comments

* Add workflow json definition for serialization

* Formmating

* Address comments
    Tao Chen · 2025-09-30 23:40:04 +00:00
    042099009f
  • .NET: Fix some more static analysis diagnostics (#1025) 
    * S1006

* S2219

* S3236

* S3260

* S1125

* IDE0063

* IDE0062

* IDE0028
    Stephen Toub · 2025-09-30 22:50:22 +00:00
    2539282d30
  • Clean up a few ifdefs (#1016)
    Stephen Toub · 2025-09-30 18:58:00 +00:00
    2d2a5bcd66
  • .Net: Visualizing dotnet workflows (#882) 
    * Adding more test for workflow vizualization.

* Improving README for sample.

* More cleanup.

* Removing rendering of workflow visualization and adding basic support for mermaid format.

* Adding basic mermaid tests.

* Improving sample. Switching to another branch.

* About to merge from main.

* Formatting.

* More fromatting.

* Removng uneeded call to ToUpper.

* Adding README.

* Moving samples under workflow to workflows.

* Removing uneeded README for map-reduce sample.
    Ben Thomas · 2025-09-30 16:29:19 +00:00
    df3e12b2ed
  • .NET: Clean up some CancellationToken usage (#996) 
    * Clean up some CancellationToken usage

* Unused usings
    Stephen Toub · 2025-09-30 13:44:53 +00:00
    4fd61924fc
  • .NET: Clean up stale mentions of M.E.AI.Agents (#997) 
    * Clean up stale mentions of M.E.AI.Agents

* Unused usings
    Stephen Toub · 2025-09-30 08:36:06 +00:00
    77e5f527c4
  • .NET: Rename workflows projects (#975) 
    * Renaming Microsoft.Agent.Workflows to Microsoft.Agents.AI.Workflows

* Removing local settings.

* Removing remining old files from merge.
    Ben Thomas · 2025-09-29 18:30:45 +00:00
    647db9635a