計画とタスク

プロバイダーをインポートして構築した後、 ChatClientAgentOptions.AIContextProvidersを使用してプロバイダーを追加します。

using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

var todoProvider = new TodoProvider();
var modeProvider = new AgentModeProvider(
    new AgentModeProviderOptions
    {
        DefaultMode = "plan",
    });

AIAgent agent = chatClient.AsAIAgent(new ChatClientAgentOptions
{
    AIContextProviders = [todoProvider, modeProvider],
});

AgentSession session = await agent.CreateSessionAsync();

AgentModeProviderOptions.Modesを使用してモード名と指示をカスタマイズします。 .NET todo プロバイダーは、状態をAgentSession.StateBagに格納します。 TodoProviderOptions は、命令を置き換えたり、挿入された todo-list メッセージを抑制したり、カスタム メッセージ ビルダーを提供したりできます。

既定の plan 命令には、プランのファイル メモリへの書き込みが含まれます。 手動で構成されたエージェントがファイル メモリ ツールを提供していない場合は、モード命令をカスタマイズするか、適切なメモリ プロバイダーを追加します。

アプリケーションからモードを変更する

await modeProvider.SetModeAsync(session, "execute");

GetModeAsyncを使用して現在のモードを読み取ります。

プロバイダーをインポートして構築し、通常の Agentに追加します。

from agent_framework import (
    Agent,
    AgentModeProvider,
    TodoFileStore,
    TodoProvider,
)

todo_provider = TodoProvider(
    store=TodoFileStore("./todo-state"),
)
mode_provider = AgentModeProvider(
    default_mode="plan",
)

agent = Agent(
    client=client,
    context_providers=[todo_provider, mode_provider],
)

session = agent.create_session()

TodoProvider では、既定で TodoSessionStore が使用されます。 todo 状態をセッション ペイロードの外部に格納する必要がある場合は、 TodoFileStore またはカスタム TodoStore を使用します。 AgentModeProvider(mode_instructions={...})を使用してモードをカスタマイズします。

既定の plan 命令には、プランのファイル メモリへの書き込みが含まれます。 手動で構成されたエージェントでファイル メモリ ツールが提供されない場合は、 mode_instructions をカスタマイズするか、適切なメモリ プロバイダーを追加します。

アプリケーションからモードを変更する

from agent_framework import get_agent_mode, set_agent_mode

set_agent_mode(
    session,
    "execute",
    source_id=mode_provider.source_id,
    available_modes=mode_provider.available_modes,
)

current_mode = get_agent_mode(
    session,
    source_id=mode_provider.source_id,
    default_mode=mode_provider.default_mode,
    available_modes=mode_provider.available_modes,
)

手動で作成したエージェントを LoopAgentでラップします。 TodoCompletionLoopEvaluator では、ループを選択したモードに制限できます。

AIAgent loopingAgent = new LoopAgent(
    agent,
    new TodoCompletionLoopEvaluator(
        new TodoCompletionLoopEvaluatorOptions
        {
            Modes = ["execute"],
        }),
    new LoopAgentOptions { MaxIterations = 10 });

通常のエージェントに AgentLoopMiddleware を追加し、モード フィルターで todos_remaining() を使用します。

from agent_framework import (
    Agent,
    AgentLoopMiddleware,
    todos_remaining,
    todos_remaining_message,
)

agent = Agent(
    client=client,
    context_providers=[todo_provider, mode_provider],
    middleware=[
        AgentLoopMiddleware(
            todos_remaining(looping_modes=["execute"]),
            next_message=todos_remaining_message,
            max_iterations=10,
        )
    ],
)

Todo ドリブン ループ統合は、Go では現在使用できません。

HarnessAgent では、既定で TodoProvider と AgentModeProvider が有効になります。 HarnessAgentOptionsを使用して、モード プロバイダーとオプションの todo ドリブン ループを構成します。

using Microsoft.Agents.AI;
using Microsoft.Extensions.AI;

var options = new HarnessAgentOptions
{
    AgentModeProviderOptions = new AgentModeProviderOptions
    {
        DefaultMode = "plan",
    },
    LoopEvaluators =
    [
        new TodoCompletionLoopEvaluator(
            new TodoCompletionLoopEvaluatorOptions
            {
                Modes = ["execute"],
            }),
    ],
    LoopAgentOptions = new LoopAgentOptions { MaxIterations = 10 },
};

HarnessAgent agent = chatClient.AsHarnessAgent(options);
// Equivalent construction: new HarnessAgent(chatClient, options)
AgentSession session = await agent.CreateSessionAsync();

既定のプロバイダーを削除するには、 DisableTodoProvider または DisableAgentModeProvider を設定します。 構成済みの TodoProviderを使用するには、既定値を無効にし、 AIContextProvidersを使用してインスタンスを追加します。 agent.GetService<TProvider>()を通じて有効なプロバイダーを解決できます。

create_harness_agent では、両方のプロバイダーが既定で有効になります。 設定済みのインスタンスを指定して置き換え、オプションの TODO 駆動ループを追加します。

from agent_framework import (
    AgentModeProvider,
    TodoFileStore,
    TodoProvider,
    create_harness_agent,
    todos_remaining,
    todos_remaining_message,
)

todo_provider = TodoProvider(store=TodoFileStore("./todo-state"))
mode_provider = AgentModeProvider(default_mode="plan")

agent = create_harness_agent(
    client=client,
    todo_provider=todo_provider,
    mode_provider=mode_provider,
    loop_should_continue=todos_remaining(looping_modes=["execute"]),
    loop_next_message=todos_remaining_message,
    loop_max_iterations=10,
)
session = agent.create_session()

既定のプロバイダーを削除するには、 disable_todo または disable_mode を設定します。 Python ハーネスでは、ツールの自動承認ミドルウェアが既定で有効になるため、実行ごとにsession渡します。