Repository Public
1# Migrate from Agent Builder23> For the complete documentation index, see [llms.txt](/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.45Use this guide to export an existing Agent Builder workflow as Agents SDK code.6You can use the export to recreate the workflow as a ChatGPT Workspace Agent or7continue with the Agents SDK in your application.89This process does not convert your workflow graph or guarantee that every10behavior transfers unchanged.1112## Choose a migration path1314- **Agents SDK**: Best for building agents through code.15- **ChatGPT Workspace Agents**: Best for building agents through natural16 language and sharing them with teams.1718## Before you migrate1920You need access to the workflow in21[Agent Builder](https://developers.openai.com/api/docs/guides/agent-builder).2223## Export your workflow24251. Open your workflow in Agent Builder.261. Select **Code** in the top navigation.271. Select **Agents SDK** in the code dialog.281. Select **TypeScript** or **Python**, then copy the complete export.29303132## Option 1: Continue with the Agents SDK3334Use this option when you want to run the exported workflow in an application35you build and deploy.3637Copy the TypeScript or Python export into your application, install and38configure the matching Agents SDK, and test the workflow in your runtime. For39guidance on configuring and running the export, see the40[Agents SDK overview](https://developers.openai.com/api/docs/guides/agents) and41[quickstart](https://developers.openai.com/api/docs/guides/agents/quickstart).42Validate your application's configuration and behavior before deploying it.4344## Option 2: Create a workspace agent from the export4546To use this option, you need a ChatGPT Business, Enterprise, or Edu workspace47with access to [workspace agents](https://chatgpt.com/agents) and permission to48create agents.4950In ChatGPT, [create a workspace agent](https://chatgpt.com/agents/studio/new).51Paste your exported code into the chat with this prompt:5253```text54Please help me convert this workflow into an agent:5556<paste your exported code here>57```5859Review any behavior that the builder identifies as requiring changes before you60continue.6162## Review and test the agent6364Some workflow behavior may need manual recreation. Review control flow,65triggers, tools, and permissions as you test the migrated agent.6667Before creating the agent:68691. Review the generated instructions and configured capabilities.701. Configure any required apps, tools, skills, authentication, and connection71 permissions.721. Select **Preview** and test representative inputs from the original73 workflow.741. Compare the previewed behavior with the original workflow's expected75 behavior.761. Select **Create** only after you have validated the migrated agent.7778Follow the same safety practices you used for your workflow, especially when79the agent can access private data or take actions through connected tools.8081## Limitations8283- Workflows with strong determinism at their core may not migrate faithfully to84 a workspace agent.85- Connected apps, authentication, publishing, and permission configuration86 require separate review in ChatGPT.87- An Agents SDK implementation requires you to validate your application's88 runtime configuration, tools, authentication, permissions, and deployment.8990## Related resources9192- [Agent Builder](https://developers.openai.com/api/docs/guides/agent-builder)93- [Safety in building agents](https://developers.openai.com/api/docs/guides/agent-builder-safety)94- [Agents SDK overview](https://developers.openai.com/api/docs/guides/agents)95- [Agents SDK quickstart](https://developers.openai.com/api/docs/guides/agents/quickstart)96- [Build workspace agents in ChatGPT for repeatable work](https://developers.openai.com/cookbook/articles/chatgpt-agents-sales-meeting-prep)