Planowanie i dozowanie

Zaimportuj i utwórz dostawców, a następnie dodaj ich za pomocą elementu 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();

Dostosowywanie nazw trybów i instrukcji za pomocą polecenia AgentModeProviderOptions.Modes. Dostawca listy zadań .NET przechowuje stan w AgentSession.StateBag. TodoProviderOptions może zastąpić swoje instrukcje, pominąć wstrzyknięty komunikat z listą zadań do wykonania lub zdefiniować niestandardowy kreator komunikatów.

plan Domyślne instrukcje obejmują zapisanie planu w pamięci pliku. Jeśli ręcznie skomponowany agent nie udostępnia narzędzi pamięci plików, dostosuj instrukcje trybu lub dodaj odpowiedniego dostawcę pamięci.

Zmienianie trybów z aplikacji

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

Użyj GetModeAsync, aby odczytać bieżący tryb.

Zaimportuj i utwórz providery, a następnie dodaj je do zwykłego elementu 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 używa TodoSessionStore domyślnie. Użyj TodoFileStore lub niestandardowego TodoStore, gdy stan zadania do wykonania musi być przechowywany poza ładunkiem danych sesji. Dostosowywanie trybów za pomocą polecenia AgentModeProvider(mode_instructions={...}).

plan Domyślne instrukcje obejmują zapisanie planu w pamięci pliku. Jeśli ręcznie skomponowany agent nie udostępnia narzędzi pamięci plików, dostosuj mode_instructions lub dodaj odpowiedniego dostawcę pamięci.

Zmienianie trybów z aplikacji

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

Pomiń available_modes, aby użyć wbudowanych trybów plan i execute. Jeśli przekażesz available_modes, musi on zawierać co najmniej jeden tryb; pusta sekwencja powoduje zgłoszenie wyjątku ValueError, zanim stan sesji zostanie zmieniony.

Narzędzia trybu sterowania z aplikacji

Ukryj narzędzie trybu wbudowanego, gdy aplikacja dostarcza własny interfejs użytkownika lub narzędzie do obsługi modelu:

mode_provider = AgentModeProvider(
    default_mode="plan",
    expose_mode_set=False,
    expose_mode_get=False,
)

Dwie opcje są niezależne i domyślnie mają wartość True. Ukrycie obu narzędzi zachowuje stan trybu powiązany z sesją, instrukcje dla poszczególnych tur oraz zewnętrzne powiadomienia o zmianie trybu. Dodaj zastępcze narzędzie udostępniane modelowi przez argument tools agenta i spraw, aby wywoływało set_agent_mode(..., notify=False), ponieważ model już obserwuje wynik działania tego narzędzia. Zmiany aplikacji lub interfejsu użytkownika mogą zachować wartość domyślną notify=True , aby agent odbierał powiadomienie o zmianie podczas następnego uruchomienia.

Otocz ręcznie skomponowanego agenta elementem LoopAgent. TodoCompletionLoopEvaluator może ograniczyć pętlę do wybranych trybów:

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

Dodaj AgentLoopMiddleware do standardowego agenta i użyj todos_remaining() z filtrem trybu:

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

Integracja pętli todo-driven nie jest obecnie dostępna w języku Go.

HarnessAgent włącza TodoProvider i AgentModeProvider domyślnie. Skonfiguruj dostawcę trybu i opcjonalną pętlę sterowaną listą zadań za pomocą elementu 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();

Ustaw DisableTodoProvider lub DisableAgentModeProvider usuń domyślnego dostawcę. Aby użyć skonfigurowanego TodoProvider, wyłącz ustawienie domyślne i dodaj swoją instancję za pomocą AIContextProviders. Możesz rozwiązać problemy z włączonymi dostawcami za pomocą usługi agent.GetService<TProvider>().

create_harness_agent włącza domyślnie obu dostawców. Dostarcz skonfigurowane instancje w celu ich zastąpienia i dodaj opcjonalną pętlę sterowaną przez 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()

Ustaw disable_todo lub disable_mode usuń domyślnego dostawcę. Mechanizm uruchomieniowy Pythona domyślnie włącza middleware automatycznego zatwierdzania narzędzi, dlatego przy każdym uruchomieniu przekaż session.