에이전트 프레임워크 워크플로는 코드, 에이전트, 상태, 이벤트 및 사용자 입력을 조정하기 위한 명시적이고 검사 가능한 실행 경로를 정의합니다. 프레임워크는 동일한 워크플로 실행 모델에 대해 기능 및 그래프 기반 API를 제공합니다.
워크플로 API
모든 SDK는 그래프 기반 워크플로를 지원합니다. Python 또한 실험적 기능 워크플로 API를 제공합니다.
.NET SDK는 그래프 기반 WorkflowBuilder API를 사용합니다. 이 시스템에서는 엣지와 조건을 통해 유형이 지정된 실행기를 연결하고, 팬아웃 및 팬인 실행을 지원하며, 워크플로 및 실행기 이벤트를 발생시키고, 슈퍼스텝 경계에서 진행 상황을 체크포인트합니다. 호환되는 워크플로는 AsAIAgent()를 사용해 표준 에이전트 인터페이스를 통해 제공될 수 있습니다.
- 워크플로 작성기 및 실행에서는 .NET 워크플로 그래프를 빌드하고 실행하는 방법을 설명합니다.
- 실행기, 에지, 이벤트 및 상태 관리는 그래프 런타임 기본 형식을 설명합니다.
- 함수 워크플로 API는 Python 함수 및 네이티브 제어 흐름을 사용합니다.
- 워크플로 작성기 및 실행 은 형식 유효성이 검사된 워크플로 그래프를 생성하고 실행합니다.
두 API 모두 동일한 관찰 가능한 워크플로 결과를 생성합니다. 표현하려는 실행 모델과 일치하는 API를 선택합니다.
기능적(@workflow) |
그래프(WorkflowBuilder) |
|
|---|---|---|
| 제어 흐름 | 네이티브 파이썬(if, 루프, asyncio.gather) |
가장자리 및 조건 |
| 최적입니다 | 순차 파이프라인, 사용자 지정 루프 및 임시 병렬 처리 | 고정 그래프, 팬아웃/팬인 및 유형 검증 메시지 라우팅 |
| Parallelism | asyncio.gather |
병렬 에지 그룹 및 슈퍼스텝 실행 |
| 관찰 가능성 | 단계별 이벤트 @step를 사용하여 |
실행기별 이벤트 |
| 휴먼 인 더 루프 | ctx.request_info() |
RequestInfoExecutor |
| 체크포인팅 | 결과별@step 캐싱 |
슈퍼스텝 경계 검사점 |
| 에이전트 래핑 |
.as_agent() 에 FunctionalWorkflow |
.as_agent() 에 Workflow |
Go SDK는 그래프 기반 workflow.NewBuilder API를 사용합니다. 에지, 조건, 팬아웃 또는 팬인 그룹을 통해 바인딩된 실행기들을 연결한 다음, inproc.Default와 같은 실행 환경에서 그래프를 실행합니다.
agentworkflow.NewAgent(...)를 사용하여 표준 에이전트 인터페이스를 통해 호환되는 워크플로를 노출합니다. 워크플로 내에서 에이전트를 실행기로 호스트하는 데 사용합니다 agentworkflow.New(...) .
- 워크플로 작성기 및 실행 에서는 Go 워크플로 그래프를 빌드하고 실행하는 방법을 설명합니다.
- 실행기, 에지, 이벤트 및 상태 관리는 그래프 런타임 기본 형식을 설명합니다.
그래프 및 런타임 모델
- 실행기는 입력을 수신하고, 작업을 수행하고, 출력을 내보낸다.
- 엣지는 실행기 간에 값을 전달합니다.
- 이벤트는 워크플로 수명 주기 및 실행 작업을 노출합니다.
- 상태 관리는 지속성 및 실행 범위 워크플로 상태를 제어합니다.
고급 실행
- 에이전트 실행기는 에이전트를 워크플로 그래프에 통합합니다.
- 워크플로 실행 모드는 스트리밍 및 비 스트리밍 실행을 설명합니다.
- 초기화 가능 실행기는 실행 간에 다시 설정되는 실행기를 설명합니다.
- 서브 워크플로는 더 큰 그래프 내에서 워크플로를 실행자로 사용해 구성합니다.
검사점, 휴먼 인 더 루프, 시각화 및 오케스트레이션과 같은 기능 지향 지침은 워크플로 기능을 참조하세요.