Planung und Aufgaben

Importieren und initialisieren Sie die Provider und fügen Sie sie anschließend über ChatClientAgentOptions.AIContextProviders hinzu:

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();

Anpassen von Modusnamen und Anweisungen mit AgentModeProviderOptions.Modes. Der .NET todo-Anbieter speichert den Zustand in AgentSession.StateBag. TodoProviderOptions kann seine Anweisungen ersetzen, die eingefügte Todo-Listennachricht unterdrücken oder einen benutzerdefinierten Nachrichten-Generator bereitstellen.

Die Standardanweisungen plan umfassen das Schreiben des Plans in den Dateispeicher. Wenn der manuell zusammengesetzte Agent keine Dateispeichertools bereitstellt, passen Sie die Modusanweisungen an, oder fügen Sie einen geeigneten Speicheranbieter hinzu.

Modi in der Anwendung ändern

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

Verwenden Sie GetModeAsync, um den aktuellen Modus zu lesen.

Importieren und erstellen Sie die Provider und fügen Sie sie dann einem normalen Agent-Element hinzu:

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 verwendet standardmäßig TodoSessionStore. Verwenden Sie TodoFileStore oder ein benutzerdefiniertes TodoStore, wenn der To-do-Status außerhalb der Sitzungsnutzlast gespeichert werden muss. Passen Sie Modi mit AgentModeProvider(mode_instructions={...}) an.

Die Standardanweisungen plan umfassen das Schreiben des Plans in den Dateispeicher. Wenn der manuell zusammengesetzte Agent keine Dateispeicher-Tools bereitstellt, passen Sie mode_instructions an oder fügen Sie einen geeigneten Speicheranbieter hinzu.

Modi in der Anwendung ändern

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,
)

Schließen Sie den manuell zusammengesetzten Agent mit LoopAgent. TodoCompletionLoopEvaluator kann die Wiederholung auf ausgewählte Modi beschränken:

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

AgentLoopMiddleware zum regulären Agenten hinzufügen und todos_remaining() mit einem Modusfilter verwenden:

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,
        )
    ],
)

Eine TODO-gesteuerte Integration in Schleifen ist in Go derzeit nicht verfügbar.

HarnessAgent aktiviert TodoProvider und AgentModeProvider standardmäßig. Konfigurieren Sie den Modus-Anbieter und die optionale todo-gesteuerte Schleife über HarnessAgentOptions:

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();

Legen Sie DisableTodoProvider oder DisableAgentModeProvider fest, um einen Standardanbieter zu entfernen. Um eine konfigurierte TodoProvider zu verwenden, deaktivieren Sie den Standard und fügen Sie Ihre Instanz über AIContextProviders hinzu. Sie können aktivierte Anbieter über agent.GetService<TProvider>() auflösen.

create_harness_agent aktiviert standardmäßig beide Anbieter. Konfigurierte Instanzen bereitstellen, um sie zu ersetzen, und eine optionale TODO-gesteuerte Schleife hinzufügen:

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()

Legen Sie disable_todo oder disable_mode fest, um einen Standardanbieter zu entfernen. Das Python-Harness aktiviert standardmäßig die Middleware zur automatischen Genehmigung von Tools. Übergeben Sie daher bei jeder Ausführung session.