순차 오케스트레이션

중요합니다

에이전트 프레임워크의 에이전트 오케스트레이션 기능은 실험적 단계에 있습니다. 현재 개발 중이며 미리 보기 또는 릴리스 후보 단계로 넘어가기 전에 크게 변경될 수 있습니다.

순차 오케스트레이션에서 에이전트는 파이프라인에 배치됩니다. 각 에이전트는 차례로 작업을 처리하여 순서대로 다음 에이전트에 출력을 전달합니다. 이는 문서 검토, 데이터 처리 파이프라인 또는 다단계 추론과 같이 각 단계가 이전 단계를 기반으로 빌드되는 워크플로에 적합합니다.

패턴을 사용하는 시기 또는 워크로드에서 패턴을 피해야 하는 경우와 같은 패턴에 대한 자세한 내용은 순차 오케스트레이션을 참조하세요.

일반 사용 예

문서는 요약 에이전트를 거쳐 번역 에이전트를 거친 후 마지막으로 품질 보증 에이전트를 거치면서 각 단계의 결과물을 개선합니다.

다이어그램

학습 내용

각각 특수한 역할이 있는 에이전트 시퀀스를 정의하는 방법
각 에이전트가 이전 에이전트의 출력을 처리하도록 이러한 에이전트를 오케스트레이션하는 방법
중간 출력을 관찰하고 최종 결과를 수집하는 방법

에이전트를 정의하십시오

에이전트는 작업을 순서대로 처리하는 특수 엔터티입니다. 여기서는 분석가, 카피라이터 및 편집자의 세 가지 에이전트를 정의합니다.

팁 (조언)

여기서 ChatCompletionAgent 는 사용되지만 모든 에이전트 유형을 사용할 수 있습니다.

using Microsoft.SemanticKernel;
using Microsoft.SemanticKernel.Agents;
using Microsoft.SemanticKernel.Agents.Orchestration;
using Microsoft.SemanticKernel.Agents.Orchestration.Sequential;
using Microsoft.SemanticKernel.Agents.Runtime.InProcess;

// Create a kernel with an AI service
Kernel kernel = ...;

ChatCompletionAgent analystAgent = new ChatCompletionAgent {
    Name = "Analyst",
    Instructions = "You are a marketing analyst. Given a product description, identify:\n- Key features\n- Target audience\n- Unique selling points",
    Kernel = kernel,
};

ChatCompletionAgent writerAgent = new ChatCompletionAgent {
    Name = "Copywriter",
    Instructions = "You are a marketing copywriter. Given a block of text describing features, audience, and USPs, compose a compelling marketing copy (like a newsletter section) that highlights these points. Output should be short (around 150 words), output just the copy as a single text block.",
    Kernel = kernel,
};

ChatCompletionAgent editorAgent = new ChatCompletionAgent {
    Name = "Editor",
    Instructions = "You are an editor. Given the draft copy, correct grammar, improve clarity, ensure consistent tone, give format and make it polished. Output the final improved copy as a single text block.",
    Kernel = kernel,
};

선택 사항: 에이전트 응답 관찰

속성을 통해 시퀀스가 진행됨에 따라 에이전트 응답을 캡처하는 콜백을 ResponseCallback 만들 수 있습니다.

ChatHistory history = [];

ValueTask responseCallback(ChatMessageContent response)
{
    history.Add(response);
    return ValueTask.CompletedTask;
}