Hintergrund-Agents

Importieren Sie BackgroundAgentsProvider und fügen Sie es mithilfe von ChatClientAgentOptions.AIContextProviders zu einem regulären Agenten hinzu:

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= an BackgroundAgentsProvider, um dessen Anweisungen zu ersetzen. Fügen Sie {background_agents} an der Stelle ein, an der die formatierte Liste der untergeordneten Agents erscheinen soll.

Umschließen Sie das manuell erstellte ü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 Evaluator stoppt bei abgeschlossenen, fehlgeschlagenen und verlorenen Aufgaben.

Fügen Sie AgentLoopMiddleware dem regulären Elternelement hinzu, und koppeln Sie das Prädikat für Hintergrundaufgaben mit seiner Hilfsfunktion 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 gilt nur so lange, wie der gespeicherte Aufgabenzustand weiterhin eine laufende Aufgabe angibt.

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

Legen Sie HarnessAgentOptions.BackgroundAgents fest. Fügen Sie den Abschlussauswerter hinzu, wenn das übergeordnete Element weiterlaufen soll, bis die delegierte Aufgabe nicht mehr läuft:

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

Verwenden Sie HarnessAgentOptions.BackgroundAgentsProviderOptions, um Anweisungen für Anbieter und die Formatierung der Agentenliste anzupassen. Das Weglassen von LoopEvaluators sorgt dafür, dass die Hintergrunddelegierung ohne automatische erneute Ausführung verfügbar bleibt.

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

Verwenden Sie background_agents_instructions, um die Anweisungen des Anbieters zu ersetzen. Das Python-Harness aktiviert standardmäßig die Middleware zur automatischen Genehmigung von Tools. Übergeben Sie daher bei jeder Ausführung session.