Agenty działające w tle

Zaimportuj BackgroundAgentsProvider i dodaj go do zwykłego agenta przez ChatClientAgentOptions.AIContextProviders:

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

var backgroundProvider = new BackgroundAgentsProvider(
    [webSearchAgent, codeAnalysisAgent]);

AIAgent parentAgent = chatClient.AsAIAgent(new ChatClientAgentOptions
{
    Name = "research-coordinator",
    AIContextProviders = [backgroundProvider],
});

AgentSession session = await parentAgent.CreateSessionAsync();

BackgroundAgentsProviderOptions dostosowuje instrukcje dostawcy i formatowanie listy agentów.

from agent_framework import Agent, BackgroundAgentsProvider

background_provider = BackgroundAgentsProvider(
    [web_search_agent, code_analysis_agent],
    wait_timeout_seconds=30,
)

parent_agent = Agent(
    client=client,
    name="research-coordinator",
    context_providers=[background_provider],
)
session = parent_agent.create_session()

Przekaż instructions= do BackgroundAgentsProvider, aby zastąpić jego instrukcje. Umieść {background_agents} w miejscu, w którym powinna zostać wyświetlona sformatowana lista agentów podrzędnych.

wait_timeout_seconds ustawia czas oczekiwania poszczególnych wywołań background_agents_wait_for_first_completion . Musi to być dodatnia liczba całkowita i wartość domyślna to 300 sekund. Jeśli limit czasu wygaśnie, narzędzie zakończy działanie normalnie i pozostawi zadania uruchomione, aby proces nadrzędny mógł wywołać je ponownie.

Gdy host eksmituje lub odrzuca sesję nadrzędną, zwolnij zadanie w procesie dostawcy i obsługę sesji podrzędnej finally w bloku:

session = parent_agent.create_session()
try:
    await parent_agent.run("Coordinate the research.", session=session)
finally:
    await background_provider.release_session(session)

release_session(session, *, cancel_running=True, timeout=30.0) jest interfejsem API cyklu życia po stronie hosta, a nie narzędziem przeznaczonym dla modelu. Domyślnie anuluje uruchamianie podrzędnych zadań i czeka do 30 sekund na anulowanie przed zwolnieniem całego stanu środowiska uruchomieniowego dla sesji nadrzędnej. Ustaw wartość cancel_running=False tak, aby odrzucała wydanie podczas wykonywania zadań, lub ustaw wartość timeout=None, aby czekać bezterminowo.

Z kolei background_agents_clear_completed_task umożliwia modelowi usunięcie jednego zadania terminala i jego sesji podrzędnej podczas rozmowy. Odrzuca uruchamianie zadań i nie zastępuje zamykania sesji nadrzędnej po stronie hosta.

Zawijaj ręcznie skomponowany element nadrzędny za pomocą polecenia LoopAgent. BackgroundTaskCompletionLoopEvaluator trwa tylko wtedy, gdy zadanie pozostaje w Running stanie:

AIAgent loopingParent = new LoopAgent(
    parentAgent,
    new BackgroundTaskCompletionLoopEvaluator(),
    new LoopAgentOptions { MaxIterations = 10 });

Ewaluator zatrzymuje się w przypadku ukończonych, nieudanych i utraconych zadań.

Dodaj AgentLoopMiddleware do zwykłego elementu nadrzędnego i połącz predykat zadania w tle z pomocnikiem następnej wiadomości:

from agent_framework import (
    Agent,
    AgentLoopMiddleware,
    background_tasks_running,
    background_tasks_running_message,
)

parent_agent = Agent(
    client=client,
    context_providers=[background_provider],
    middleware=[
        AgentLoopMiddleware(
            background_tasks_running(),
            next_message=background_tasks_running_message,
            max_iterations=10,
        )
    ],
)

Predykat pozostaje spełniony tylko tak długo, jak długo utrwalony stan zadania nadal wskazuje, że zadanie jest uruchomione.

Automatyczna integracja pętli zadań w tle nie jest obecnie dostępna w języku Go.

Ustaw wartość HarnessAgentOptions.BackgroundAgents. Dodaj moduł oceny ukończenia, gdy element nadrzędny powinien działać, dopóki delegowana praca nie jest już wykonywana:

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

var options = new HarnessAgentOptions
{
    Name = "research-coordinator",
    BackgroundAgents = [webSearchAgent, codeAnalysisAgent],
    LoopEvaluators = [new BackgroundTaskCompletionLoopEvaluator()],
    LoopAgentOptions = new LoopAgentOptions { MaxIterations = 10 },
};

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

Użyj HarnessAgentOptions.BackgroundAgentsProviderOptions, aby dostosować instrukcje dostawcy i formatowanie listy agentów. Pominięcie elementu LoopEvaluators sprawia, że delegowanie w tle pozostaje dostępne bez automatycznego ponownego wywołania.

Podaj background_agents do create_harness_agent. Połącz to z ograniczoną pętlą, gdy element nadrzędny powinien czekać automatycznie:

from agent_framework import (
    background_tasks_running,
    background_tasks_running_message,
    create_harness_agent,
)

parent_agent = create_harness_agent(
    client=client,
    name="research-coordinator",
    background_agents=[web_search_agent, code_analysis_agent],
    background_agents_wait_timeout_seconds=30,
    loop_should_continue=background_tasks_running(),
    loop_next_message=background_tasks_running_message,
    loop_max_iterations=10,
)
session = parent_agent.create_session()

Użyj polecenia background_agents_instructions , aby zastąpić instrukcje dostawcy. background_agents_wait_timeout_seconds konfiguruje ten sam ograniczony czas oczekiwania co wait_timeout_seconds na BackgroundAgentsProvider. Mechanizm uruchomieniowy Pythona domyślnie włącza middleware automatycznego zatwierdzania narzędzi, dlatego przy każdym uruchomieniu przekaż session.