Hintergrund-Agents

Importieren BackgroundAgentsProvider und hinzufügen sie zu einem regulären Agent über 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 passt die Anbieteranweisungen und die Agentlistenformatierung an.

from agent_framework import Agent, BackgroundAgentsProvider

background_provider = BackgroundAgentsProvider(
    [web_search_agent, code_analysis_agent]
)

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

Übergeben Sie instructions= die Anweisungen, BackgroundAgentsProvider um ihre Anweisungen zu ersetzen. Geben Sie an {background_agents} , wo die formatierte untergeordnete Agent-Liste angezeigt werden soll.

Schließen Sie das manuell verfasste übergeordnete Element mit LoopAgent. BackgroundTaskCompletionLoopEvaluator wird nur fortgesetzt, während ein Vorgang im Running Zustand verbleibt:

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

Der Auswertungsvorgang wird für abgeschlossene, fehlgeschlagene und verlorene Vorgänge beendet.

Fügen Sie dem regulären übergeordneten Element hinzu, und koppeln Sie AgentLoopMiddleware das Hintergrundaufgaben-Prädikat mit dem Hilfsprogramm für die nächste Nachricht:

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

Das Prädikat wird nur fortgesetzt, während der permanente Aufgabenstatus weiterhin eine ausgeführte Aufgabe meldet.

Die automatische Integration von Hintergrundaufgabenschleifen ist derzeit in Go nicht verfügbar.

Legen Sie HarnessAgentOptions.BackgroundAgents fest. Fügen Sie den Abschluss-Evaluator hinzu, wenn das übergeordnete Element weiter ausgeführt werden soll, bis delegierte Arbeit nicht mehr ausgeführt wird:

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

Wird verwendet HarnessAgentOptions.BackgroundAgentsProviderOptions , um Anbieteranweisungen und Agentlistenformatierungen anzupassen. Beim Auslassen LoopEvaluators bleibt die Hintergrunddelegierung ohne automatische Erneutes Aufrufen verfügbar.

Lieferung background_agents an create_harness_agent. Koppeln Sie sie mit einer gebundenen Schleife, wenn das übergeordnete Element automatisch warten soll:

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],
    loop_should_continue=background_tasks_running(),
    loop_next_message=background_tasks_running_message,
    loop_max_iterations=10,
)
session = parent_agent.create_session()

Wird verwendet background_agents_instructions , um die Anbieteranweisungen zu ersetzen. Die Python-Nutzung ermöglicht standardmäßig die Middleware für die automatische Genehmigung von Tools. Übergeben session Sie daher jede Ausführung.