Agent Builder에서 마이그레이션하기

기존 Agent Builder 워크플로우를 Agents SDK 코드로 내보내는 방법을 안내하는 가이드예요. 내보낸 코드를 사용해 ChatGPT Workspace Agent로 재구성하거나 애플리케이션에서 Agents SDK를 계속 사용할 수 있어요.

출처: 문서

본문

기존 Agent Builder 워크플로우를 Agents SDK 코드로 내보내려면 이 가이드를 사용하세요. 내보내기를 사용해 워크플로우를 ChatGPT Workspace Agent로 재구성하거나, 애플리케이션에서 Agents SDK를 계속 사용할 수 있어요.

이 과정은 여러분의 워크플로우 그래프를 변환하거나 모든 동작이 변경 없이 이전된다는 것을 보장하지는 않아요.

마이그레이션 경로 선택하기

Agents SDK: 코드를 통해 에이전트를 구축하는 데 가장 적합해요.
ChatGPT Workspace Agents: 자연어로 에이전트를 구축하고 팀과 공유하는 데 가장 적합해요.

마이그레이션 전에

Agent Builder에서 워크플로우에 접근할 수 있어야 해요.

워크플로우 내보내기

Agent Builder에서 워크플로우를 엽니다.
상단 내비게이션에서 Code를 선택합니다.
코드 다이얼로그에서 Agents SDK를 선택합니다.
TypeScript 또는 Python을 선택한 뒤 전체 내보내기를 복사합니다.

Agent Builder Code dialog with Agents SDK selected

옵션 1: Agents SDK로 계속 진행하기

직접 구축하고 배포하는 애플리케이션에서 내보낸 워크플로우를 실행하고 싶을 때 이 옵션을 사용하세요.

TypeScript 또는 Python 내보내기를 애플리케이션에 복사하고, 일치하는 Agents SDK를 설치하고 설정한 뒤, 런타임에서 워크플로우를 테스트해요. 내보내기 설정 및 실행에 대한 지침은 Agents SDK overview와 quickstart를 참고하세요. 배포하기 전에 애플리케이션의 설정과 동작을 검증하세요.

옵션 2: 내보내기에서 워크스페이스 에이전트 만들기

이 옵션을 사용하려면 workspace agents에 접근할 수 있고 에이전트를 만들 권한이 있는 ChatGPT Business, Enterprise 또는 Edu 워크스페이스가 필요해요.

ChatGPT에서 create a workspace agent를 사용해 워크스페이스 에이전트를 만들어요. 내보낸 코드를 이 프롬프트와 함께 채팅에 붙여 넣어요:

Please help me convert this workflow into an agent:

<paste your exported code here>

계속하기 전에 빌더가 변경이 필요하다고 식별한 동작을 검토해요.

에이전트 검토 및 테스트

일부 워크플로우 동작은 수동으로 다시 만들어야 할 수 있어요. 마이그레이션된 에이전트를 테스트하면서 제어 흐름, 트리거, 도구, 권한을 검토해요.

에이전트를 만들기 전에:

생성된 지침과 설정된 능력을 검토해요.
필요한 앱, 도구, 스킬, 인증, 연결 권한을 설정해요.
Preview를 선택하고 원래 워크플로우의 대표 입력으로 테스트해요.
미리 본 동작을 원래 워크플로우의 기대 동작과 비교해요.
마이그레이션된 에이전트를 검증한 뒤에만 Create를 선택해요.

워크플로우에 사용했던 것과 동일한 안전 관행을 따르세요. 특히 에이전트가 비공개 데이터에 접근하거나 연결된 도구를 통해 작업을 수행할 수 있는 경우 더 중요해요.

제한 사항

핵심에 강한 결정성(determinism)이 있는 워크플로우는 워크스페이스 에이전트로 충실히 이전되지 않을 수 있어요.
연결된 앱, 인증, 게시, 권한 설정은 ChatGPT에서 별도로 검토해야 해요.
Agents SDK 구현은 애플리케이션의 런타임 설정, 도구, 인증, 권한, 배포를 직접 검증해야 해요.

더 알아보기 (Learn more)

관련 문서: Agent Builder와 Agents SDK 개요를 참고하세요.

Agent Builder에서 마이그레이션하기