중요합니다
에이전트 프레임워크의 에이전트 오케스트레이션 기능은 실험적 단계에 있습니다. 현재 개발 중이며 미리 보기 또는 릴리스 후보 단계로 넘어가기 전에 크게 변경될 수 있습니다.
의미 체계 커널의 에이전트 오케스트레이션 프레임워크를 사용하면 개발자가 복잡한 에이전트 워크플로를 쉽게 빌드, 관리 및 확장할 수 있습니다.
다중 에이전트 오케스트레이션을 사용하는 이유
기존의 단일 에이전트 시스템은 복잡한 다중 패싯 작업을 처리하는 기능이 제한됩니다. 각각 특수 기술 또는 역할을 가진 여러 에이전트를 오케스트레이션하여 보다 강력하고 적응적이며 실제 문제를 공동으로 해결할 수 있는 시스템을 만들 수 있습니다. 의미 체계 커널의 다중 에이전트 오케스트레이션은 다양한 조정 패턴을 지원하여 이러한 시스템을 빌드하기 위한 유연한 기반을 제공합니다.
오케스트레이션 패턴
잘 알려진 클라우드 디자인 패턴과 마찬가지로 에이전트 오케스트레이션 패턴은 공통의 목표를 위해 함께 작동하도록 여러 에이전트를 조정하는 기술에 구애받지 않는 접근 방식입니다. 패턴 자체에 대한 자세한 내용은 AI 에이전트 오케스트레이션 패턴 설명서를 참조하세요.
의미 체계 커널에서 지원되는 오케스트레이션 패턴
의미 체계 커널은 이러한 오케스트레이션 패턴을 SDK에서 직접 구현하여 지원합니다. 이러한 패턴은 프레임워크의 일부로 사용할 수 있으며 에이전트 공동 작업 시나리오를 조정할 수 있도록 쉽게 확장하거나 사용자 지정할 수 있습니다.
| 패턴 | 설명 | 일반적인 사용 사례 |
|---|---|---|
| 일치하는 | 작업을 모든 에이전트에 브로드캐스트하고 결과를 독립적으로 수집합니다. | 병렬 분석, 독립적인 하위 작업, 앙상블 의사 결정. |
| 순차적 | 한 에이전트의 결과를 정의된 순서로 다음 에이전트로 전달합니다. | 단계별 워크플로, 파이프라인, 다단계 처리. |
| 핸드오프 | 컨텍스트 또는 규칙에 따라 에이전트 간에 제어를 동적으로 전달합니다. | 동적 워크플로, 에스컬레이션, 대체 또는 전문가 핸드오프 시나리오. |
| 그룹 채팅 | 모든 에이전트는 그룹 관리자가 조정한 그룹 대화에 참여합니다. | 브레인스토밍, 공동 작업 문제 해결, 합의 구축. |
| 돋보기 | MagenticOne에서 영감을 받은 그룹 채팅 스타일의 오케스트레이션. | 복잡하고 일반적인 다중 에이전트 공동 작업. |
단순성 및 개발자 친화적
모든 오케스트레이션 패턴은 생성 및 호출을 위한 통합 인터페이스를 공유합니다. 어떤 오케스트레이션을 선택하든 관계없이, 사용자는 다음을 수행합니다.
- 에이전트 및 해당 기능을 정의합니다. 의미 체계 커널 에이전트를 참조하세요.
- 에이전트(및 필요한 경우 관리자)를 전달하여 오케스트레이션을 만듭니다.
- 필요에 따라 사용자 지정 입력/출력 처리를 위한 콜백 또는 변환을 제공합니다.
- 작업을 통해 오케스트레이션을 호출하고 런타임을 시작합니다.
- 일관된 비동기 방식으로 결과를 기다립니다.
이 통합 접근 방식은 새 API를 학습하거나 에이전트 논리를 다시 작성하지 않고도 오케스트레이션 패턴 간에 쉽게 전환할 수 있습니다. 프레임워크는 에이전트 통신, 조정 및 결과 집계의 복잡성을 추상화하여 애플리케이션의 목표에 집중할 수 있도록 합니다.
// Choose an orchestration pattern with your agents
SequentialOrchestration orchestration = new(agentA, agentB)
{
LoggerFactory = this.LoggerFactory
}; // or ConcurrentOrchestration, GroupChatOrchestration, HandoffOrchestration, MagenticOrchestration, ...
// Start the runtime
InProcessRuntime runtime = new();
await runtime.StartAsync();
// Invoke the orchestration and get the result
OrchestrationResult<string> result = await orchestration.InvokeAsync(task, runtime);
string text = await result.GetValueAsync();
await runtime.RunUntilIdleAsync();
# Choose an orchestration pattern with your agents
orchestration = SequentialOrchestration(members=[agent_a, agent_b])
# or ConcurrentOrchestration, GroupChatOrchestration, HandoffOrchestration, MagenticOrchestration, ...
# Start the runtime
runtime = InProcessRuntime()
runtime.start()
# Invoke the orchestration
result = await orchestration.invoke(task="Your task here", runtime=runtime)
# Get the result
final_output = await result.get()
await runtime.stop_when_idle()
비고
에이전트 오케스트레이션은 Java SDK에서 아직 사용할 수 없습니다.
개발 환경 준비
계속하기 전에 프로젝트에 다음 패키지를 추가합니다.
dotnet add package Microsoft.SemanticKernel.Agents.Orchestration --prerelease
dotnet add package Microsoft.SemanticKernel.Agents.Runtime.InProcess --prerelease
사용하는 에이전트 유형에 따라 에이전트에 대한 해당 패키지를 추가해야 할 수도 있습니다. 자세한 내용은 에이전트 개요 를 참조하세요.