mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
Shyju KrishnankuttyandGitHub
e8d0bd9051
* Add basic durable workflow support. * PR feedback fixes * Add conditional edge sample. * PR feedback fixes. * Minor cleanup. * Minor cleanup * Minor formatting improvements. * Improve comments/documentation on the execution flow.
35 lines
1.6 KiB
C#
35 lines
1.6 KiB
C#
// Copyright (c) Microsoft. All rights reserved.
|
|
|
|
namespace Microsoft.Agents.AI.DurableTask;
|
|
|
|
/// <summary>
|
|
/// Marker class used to track whether core durable task services have been registered.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// <para>
|
|
/// <b>Problem it solves:</b> Users may call configuration methods multiple times:
|
|
/// <code>
|
|
/// services.ConfigureDurableOptions(...); // 1st call - registers agent A
|
|
/// services.ConfigureDurableOptions(...); // 2nd call - registers workflow X
|
|
/// services.ConfigureDurableOptions(...); // 3rd call - registers agent B and workflow Y
|
|
/// </code>
|
|
/// Each call invokes <c>EnsureDurableServicesRegistered</c>. Without this marker, core services like
|
|
/// <c>AddDurableTaskWorker</c> and <c>AddDurableTaskClient</c> would be registered multiple times,
|
|
/// causing runtime errors or unexpected behavior.
|
|
/// </para>
|
|
/// <para>
|
|
/// <b>How it works:</b>
|
|
/// <list type="number">
|
|
/// <item><description>First call: No marker in services → register marker + all core services</description></item>
|
|
/// <item><description>Subsequent calls: Marker exists → early return, skip core service registration</description></item>
|
|
/// </list>
|
|
/// </para>
|
|
/// <para>
|
|
/// <b>Why not use TryAddSingleton for everything?</b>
|
|
/// While <c>TryAddSingleton</c> prevents duplicate simple service registrations, it doesn't work for
|
|
/// complex registrations like <c>AddDurableTaskWorker</c> which have side effects and configure
|
|
/// internal builders. The marker pattern provides a clean, explicit guard for the entire registration block.
|
|
/// </para>
|
|
/// </remarks>
|
|
internal sealed class DurableServicesMarker;
|