エージェント ハーネス

ハーネス エージェントを作成する

Microsoft.Agents.AI.Harness パッケージは、HarnessAgent名前空間のMicrosoft.Agents.AIを公開します。 IChatClientを使用して任意のAsHarnessAgentから作成するか、HarnessAgentを直接構築します。

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

AIAgent agent = chatClient.AsHarnessAgent();

AgentResponse response = await agent.RunAsync("Plan a weekend trip to Seattle.");
Console.WriteLine(response.Text);

HarnessAgentOptionsを使用して、ハーネス レベルの運用ガイダンス、エージェント固有の手順、および機能オプションを設定します。

AIAgent agent = chatClient.AsHarnessAgent(new HarnessAgentOptions
{
    Name = "research-agent",
    HarnessInstructions = "Use tools deliberately and report verified results.",
    ChatOptions = new ChatOptions
    {
        Instructions = "You are a research assistant focused on academic sources.",
    },
    MaxContextWindowTokens = 128_000,
    MaxOutputTokens = 16_384,
});

HarnessAgent.DefaultInstructions は、既定のハーネス ガイダンスを提供します。 HarnessInstructions は、 ChatOptions.Instructionsの前に表示されます。

コンポジションをカスタマイズする

既定の機能には、 DisableTodoProvider、 DisableAgentModeProvider、 DisableFileMemory、 DisableAgentSkillsProvider、 DisableWebSearch、 DisableToolAutoApproval、 DisableOpenTelemetry、 DisableCompactionなどの対象オプションがあります。

AIContextProvidersを使用してカスタム コンテキスト プロバイダーを追加します。 FileAccessStoreでのファイル アクセス、BackgroundAgentsを使用したバックグラウンド委任、および LoopEvaluators でのループを選択します。

ハーネスエージェントを作成する

create_harness_agent ファクトリは、完全に構成されたAgentを返します。

from agent_framework import create_harness_agent
from agent_framework.openai import OpenAIChatClient

agent = create_harness_agent(
    client=OpenAIChatClient(model="gpt-4o"),
)

session = agent.create_session()
response = await agent.run("Plan a weekend trip to Seattle.", session=session)
print(response.text)

ハーネス レベルとエージェント固有の命令を個別に設定します。

agent = create_harness_agent(
    client=client,
    name="research-agent",
    harness_instructions="Use tools deliberately and report verified results.",
    agent_instructions="You are a research assistant focused on academic sources.",
    max_context_window_tokens=128_000,
    max_output_tokens=16_384,
)

DEFAULT_HARNESS_INSTRUCTIONS は、既定のハーネス ガイダンスを提供します。 harness_instructions は、 agent_instructionsの前に表示されます。

コンポジションをカスタマイズする

disable_todo、disable_mode、disable_file_memory、disable_web_search、disable_tool_auto_approval、disable_compactionなどのオプションで既定値を無効にします。

組み込みのプロバイダーを todo_provider または mode_providerに置き換え、プロバイダーを context_providersに追加します。 スキルは skills_provider または skills_pathsによってオプトインされます。ファイル アクセス、バックグラウンド エージェント、シェル ツール、ループもオプトインされます。

.NETサンプル エントリ ポイントはHarnessConsole.RunAgentAsync。

using Harness.Shared.Console;

await HarnessConsole.RunAgentAsync(
    agent,
    userPrompt: "Ask me anything to get started.");

オブザーバー、ツール フォーマッタ、コマンド ハンドラー、 HarnessConsoleOptionsを使用してサンプルをカスタマイズします。 .NET ハーネスのサンプルを参照してください。

Pythonサンプルでは、Harness サンプルの横にあるテキストベースのconsole パッケージを使用します。

from console import run_agent_async

await run_agent_async(agent)

オブザーバー、フォーマッタ、コマンド、UI コンポーネントを使用してサンプルをカスタマイズします。 Python ハーネスのサンプルを参照してください。

リポジトリには現在、パッケージ化された Go Harness ターミナル サンプルは含まれていません。