Agent Builder
Agent Builder
Agent Builder는 다단계 에이전트 워크플로우를 구축하기 위한 비주얼 캔버스예요. 템플릿에서 시작하고, 워크플로우의 각 단계에 노드를 드래그 앤 드롭하며, 타입이 지정된 입력/출력을 제공하고, 실시간 데이터로 실행을 미리 볼 수 있어요.
출처: 문서
본문
Agent Builder는 다단계 에이전트 워크플로우를 구축하기 위한 비주얼 캔버스예요.
템플릿에서 시작하고, 워크플로우의 각 단계에 노드를 드래그 앤 드롭하고, 타입이 지정된 입력과 출력을 제공하고, 실시간 데이터로 실행을 미리 볼 수 있어요. 배포할 준비가 되면 ChatKit으로 워크플로우를 사이트에 임베드하거나, SDK 코드를 다운로드해 직접 실행할 수 있어요.
OpenAI는 Agent Builder를 폐기(deprecate)하고 있어요. 기존 사용자는 전환 기간 동안 계속 사용할 수 있으며, 제품은 2026년 11월 30일에 종료될 예정이에요. ChatKit은 계속 사용할 수 있어요. 현재 타임라인은 deprecations page를 참고하세요.
이 가이드를 사용해 에이전트 구축의 과정과 구성 요소를 배워요.
에이전트와 워크플로우
유용한 에이전트를 구축하려면 그들을 위한 워크플로우를 만들어요. **워크플로우(workflow)**는 에이전트, 도구, 제어 흐름 로직의 조합이에요. 워크플로우는 여러분의 작업을 처리하거나 채팅을 구동하는 데 관련된 모든 단계와 작업을 캡슐화하며, 준비되면 배포할 수 있는 작동하는 코드를 포함해요.
Open Agent Builder
작업을 처리하는 에이전트를 구축하는 데는 세 가지 주요 단계가 있어요:
- Agent Builder에서 워크플로우를 설계해요. 여기서 에이전트와 그 동작 방식을 정의해요.
- 워크플로우를 게시해요. ID와 버전 관리를 가진 객체예요.
- 워크플로우를 배포해요. ID를 ChatKit 통합에 전달하거나, Agents SDK 코드를 다운로드해 직접 배포해요.
노드로 구성하기
Agent Builder에서 노드를 삽입하고 연결해 워크플로우를 만들어요. 노드 간 각 연결은 타입이 지정된 엣지(typed edge)가 돼요. 노드를 클릭해 입력과 출력을 설정하고, 단계 간 데이터 계약(data contract)을 관찰하며, 다운스트림 노드가 기대하는 속성을 받는지 확인해요.
예시와 템플릿
Agent Builder는 일반적인 워크플로우 패턴에 대한 템플릿을 제공해요. 노드가 함께 어떻게 작동하는지 보려면 템플릿으로 시작하거나, 처음부터 시작해도 돼요.
다음은 숙제 도우미(homework helper) 워크플로우예요. 에이전트를 사용해 질문을 받고, 더 나은 답변을 위해 재구성하며, 다른 전문 에이전트로 라우팅한 뒤 답변을 반환해요.
사용 가능한 노드
노드는 에이전트를 위한 빌딩 블록이에요. 사용 가능한 모든 노드와 그 설정 옵션을 보려면 node reference documentation을 참고하세요.
미리 보기 및 디버그
구축하면서 Preview 기능을 사용해 워크플로우를 테스트할 수 있어요. 여기서 워크플로우를 대화형으로 실행하고, 샘플 파일을 첨부하며, 각 노드의 실행을 관찰할 수 있어요.
안전과 위험
에이전트 워크플로우를 구축하는 것에는 프롬프트 인젝션(prompt injection)과 데이터 누출 같은 위험이 따라와요. 에이전트 워크플로우의 위험을 배우고 완화하려면 safety in building agents를 참고하세요.
워크플로우 평가하기
Agent Builder 안에서 trace graders를 실행하세요. 상단 내비게이션에서 Evaluate를 클릭해요. 여기서 트레이스(또는 트레이스 세트)를 선택하고 커스텀 그레이더를 실행해 전체 워크플로우 성능을 평가할 수 있어요.
워크플로우 게시하기
Agent Builder는 작업할 때 자동으로 저장(autosave)해요. 워크플로우가 마음에 들면 게시해 스냅샷 역할을 하는 새로운 메이저 버전을 만들어요. 그런 다음 채팅 경험을 임베드하기 위한 OpenAI 프레임워크인 ChatKit에서 워크플로우를 사용할 수 있어요.
새 버전을 만들거나 API 호출에서 이전 버전을 지정할 수 있어요.
제품에 배포하기
만든 에이전트 워크플로우를 구현할 준비가 되면 상단 내비게이션에서 Code를 클릭해요. 프로덕션에서 워크플로우를 구현하는 두 가지 옵션이 있어요:
ChatKit: ChatKit quickstart를 따르고 워크플로우 ID를 전달해 이 워크플로우를 애플리케이션에 임베드해요. 잘 모르겠다면 이 옵션을 권장해요.
고급 통합(Advanced integration): 워크플로우 코드를 복사해 어디서든 사용해요. 자체 인프라에서 ChatKit을 실행하고 Agents SDK를 사용해 에이전트 채팅 경험을 구축하고 커스터마이즈할 수 있어요.
다음 단계
이제 에이전트 워크플로우를 만들었으니, ChatKit으로 제품에 가져와 보세요.
더 알아보기 (Learn more)
관련 문서: Agent Builder 안전과 노드 레퍼런스를 참고하세요.