에이전트 프레임워크 워크플로는 코드, 에이전트, 상태, 이벤트 및 사용자 입력을 조정하기 위한 명시적이고 검사 가능한 실행 경로를 정의합니다. 프레임워크는 동일한 워크플로 실행 모델에 대해 기능 및 그래프 기반 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.New(...)를 통해 에이전트 지향 워크플로를 노출할 수 있습니다.
- 워크플로 작성기 및 실행 에서는 Go 워크플로 그래프를 빌드하고 실행하는 방법을 설명합니다.
- 실행기, 에지, 이벤트 및 상태 관리는 그래프 런타임 기본 형식을 설명합니다.
그래프 및 런타임 모델
- 실행기는 입력을 수신하고, 작업을 수행하고, 출력을 내보낸다.
- 에지는 실행기 간에 값을 라우팅합니다.
- 이벤트는 워크플로 수명 주기 및 실행 작업을 노출합니다.
- 상태 관리는 지속성 및 실행 범위 워크플로 상태를 제어합니다.
고급 실행
- 에이전트 실행기는 에이전트를 워크플로 그래프에 통합합니다.
- 워크플로 실행 모드는 스트리밍 및 비 스트리밍 실행을 설명합니다.
- 초기화 가능 실행기는 실행 간에 다시 설정되는 실행기를 설명합니다.
- 하위 워크플로는 더 큰 그래프에서 워크플로를 실행자로 구성합니다.
검사점, 휴먼 인 더 루프, 시각화 및 오케스트레이션과 같은 기능 지향 지침은 워크플로 기능을 참조하세요.