Move your Creatio.ai agents to Creatio AI Studio
You do not have to move your Creatio.ai agents. They keep working in the Creatio.ai chat, and you decide which users see which chat. Move an agent when you want its users to work with it in Creatio AI Studio. Moving is a rebuild, not a copy: much of what a Creatio.ai agent does is already covered by the AI Twin and the Creatio tools that Creatio AI Studio connects out of the box, so a moved agent is usually smaller than the original — and some agents do not need to be moved at all. Learn more: Switch the AI Twin on in Creatio Business Studio.
Before you start
- Make sure your Creatio Business Studio is connected to Creatio AI Studio. Learn more: Get started with Creatio AI Studio.
- Make sure you have the Developer or Administrator role in Creatio AI Studio and the System administrators role in Creatio Business Studio.
Find the agents to move
- Open the Creatio.ai agents section in the AI Command Center workplace.
- Choose only the agents your users need. The agents that ship with Creatio Business Studio, for example Analytics Agent or Filter Agent, are already part of the AI Twin. Do not move them.
- Open each of your own agents and review the General information tab: the instructions, the sub-agents, the AI tools, and the Knowledge sources tab.
- Check the sub-agents in the Creatio.ai sub-agents section. Sub-agents with Workflows in the Where to use column are called by business processes. Leave them in Creatio Business Studio. Move only the sub-agents marked Prompt agents.
- Ask the AI Twin to do the same task. If the AI Twin already does it well, you do not need to move the agent.
Map the agent to Creatio AI Studio
Use the table to decide what each part of a Creatio.ai agent becomes in Creatio AI Studio.
| In the Creatio.ai agent | In Creatio AI Studio |
|---|---|
| Title, Description | Agent name and description. |
| Role, Agent instructions, Limitations and restrictions | Agent instructions (system prompt). Rewrite them for the new agent rather than pasting them as they are. |
| Model | Choose a model for the agent. Models are not carried over. |
| Sub-agent used in chats (Prompt agents) | A skill. Its Agent instructions become the skill body. |
| AI tools that read, search, or create Creatio records | Nothing to rebuild: enable the matching tools of the Creatio Business Studio integration on the agent. Read more >>> |
| AI tools that run a business process | Publish the process as an MCP tool in Creatio Business Studio, then connect it in Creatio AI Studio. Read more >>> |
| Knowledge sources | A knowledge source attached to the agent. |
| Actions that ask the user for confirmation | A tool confirmation policy. Learn more: Set up tool confirmation. |
| Permissions to execute | Who can use the agent in Creatio AI Studio. Set it when you publish the agent. |
| Conversation history | Not moved. |
Make a business process available to the agent
If a sub-agent ran a business process, publish that process as a tool.
- Open the Published MCP servers section in the AI Command Center workplace and click New.
- Fill out Name. Creatio Business Studio fills out Code from the name and Full URL from the code, for example,
https://<your site>/0/rest/ToolServiceMcp/<Code>/v1/mcp. Copy the full URL — you need it in Creatio AI Studio. - Add the process. On the Tools tab, click Add tool → Add from process, select the process in the Select process(es) window, and click Select. Creatio Business Studio saves the server and adds the tool with an External tool name built from the process title.
- Click Make it online.
- Connect the server in Creatio AI Studio. Go to Integrations, click New, and select MCP Server. Fill out Name, paste the full URL into MCP Server URL, choose the access methods, and click Connect MCP server. You can use the same credentials as for the Creatio Business Studio integration, unless the agent needs narrower access.
As a result, agents in Creatio AI Studio can call the process as a tool.
Rebuild the agent
- Create the skills. In Creatio AI Studio, go to Skills and click New. Create one skill per sub-agent you move.
- Create the agent. Go to Agents, click New → Enterprise agent, select Prompt Agent Designer, and enter the name. A company-wide agent is an enterprise agent.
- Assign the channel. On the Assign channels step, select Creatio.ai Twin. All agents share one AI Twin channel, so the agent appears in the AI Twin chat in Creatio Business Studio next to the other agents.
- Write the agent instructions on the Agent tab and attach the skills and the knowledge sources.
- Connect Creatio data. See the next section.
- Test the agent with the requests your users sent to the Creatio.ai agent.
- Publish and deploy the agent. Deploy it to the environment of your Creatio site.
As a result, the agent appears in the AI Twin chat in Creatio Business Studio. Users open the chat sidebar, click View all agents, and find the agent under Not added.
Connect Creatio data to the agent
A new agent has no access to Creatio data until you turn it on. The Creatio Business Studio integration is already connected to your organization; you only choose how the agent uses it.
- Open the agent and go to Build → Integrations. The Creatio Business Studio integration is listed.
- Select the access mode.
- Delegated access — the agent works as the signed-in user and sees only the records that user can see. Recommended for agents that people use in the chat. The first time, the agent sends each user a link to allow access.
- Integration credentials — the agent uses the integration's stored credentials, the same for every user. This is the default.
- Enable the tools the agent may call. All tools are disabled for a new agent. Enable only what the agent needs, for example, reading and searching records. Enable tools that create, change, or delete records only if the agent must do that.
- Publish the agent again.
Switch your users over
- Switch the AI Twin on for the users of the moved agent. Learn more: Switch the AI Twin on in Creatio Business Studio.
- Deactivate the Creatio.ai agent when nobody needs it anymore: open it and set Status to "Deactivated." Users of the Creatio.ai chat no longer see it.