6단계: 에이전트 하네스

IChatClient 확장 메서드를 사용하여 임의의 AsHarnessAgent에서 하니스 에이전트를 생성합니다. 하네스는 여러 단계에 걸쳐 작업을 대화형으로 처리하므로, 일반적으로 대화 루프를 통해 이를 구동합니다. 즉, 여러 턴에 걸쳐 하네스 상태(계획, 할 일, 기록)가 유지되도록 AgentSession를 계속 유지하고, 사용자의 다음 지시를 읽고, 생성되는 대로 에이전트 출력을 스트리밍합니다.

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

// chatClient is any IChatClient implementation (Foundry, Azure OpenAI, OpenAI, Anthropic, ...).
AIAgent agent = chatClient.AsHarnessAgent();

// A session carries the harness state (plan, todos, history) across turns.
AgentSession session = await agent.CreateSessionAsync();

Console.WriteLine("Harness agent ready. Type 'exit' to quit.");
while (true)
{
    Console.Write("> ");
    string? input = Console.ReadLine();
    if (string.IsNullOrWhiteSpace(input) || input.Equals("exit", StringComparison.OrdinalIgnoreCase))
    {
        break;
    }

    // Stream this turn's output as the harness plans and works through the request.
    await foreach (var update in agent.RunStreamingAsync(input, session))
    {
        Console.Write(update);
    }

    Console.WriteLine();
}

하네스는 전체 대화에 걸쳐 계획 수립, 할 일 추적, 대화 기록 유지를 대신 관리해 줍니다. 도구 승인 프롬프트, 할 일 목록/모드 렌더링, 슬래시 명령을 포함한 모든 기능을 갖춘 콘솔은 샘플 터미널 UX를 참조하세요.

create_harness_agent 팩터리로 하네스 에이전트를 생성합니다. 하네스는 여러 단계에 걸쳐 작업을 대화형으로 처리하므로, 일반적으로 대화 루프를 통해 구동합니다. 세션을 유지하여 하네스 상태(계획, 할 일 목록, 기록)가 턴 간에 지속되도록 하고, 사용자의 다음 지시를 읽고, 에이전트의 출력을 생성되는 대로 스트리밍합니다.

from agent_framework import create_harness_agent
from agent_framework.openai import OpenAIChatClient

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

# A session carries the harness state (plan, todos, history) across turns.
session = agent.create_session()

print("Harness agent ready. Type 'exit' to quit.")
while True:
    user_input = input("> ")
    if user_input.strip().lower() in {"exit", "quit"}:
        break

    # Stream this turn's output as the harness plans and works through the request.
    async for chunk in agent.run(user_input, session=session, stream=True):
        if chunk.text:
            print(chunk.text, end="", flush=True)
    print()

하네스는 전체 대화에 걸쳐 계획 수립, 할 일 추적, 대화 기록 유지를 대신 관리해 줍니다. 도구 승인 프롬프트, 할 일 목록/모드 렌더링, 슬래시 명령을 포함한 모든 기능을 갖춘 콘솔은 샘플 터미널 UX를 참조하세요.