Deploying an agent to a Boomi-managed runtime cloud
Deploy an agent to a Boomi-managed runtime cloud to run it on Boomi-hosted infrastructure in a region close to your users and data. You package a version of your agent, then deploy the package to an environment that has a runtime cloud attached.
To run your agent in your own infrastructure instead, refer to Deploying an agent to a Flex runtime. To compare the two options, refer to Comparing deployment options.
Benefits
Deploying to a Boomi-managed runtime cloud benefits your business by:
- Deploying and executing agents within specific regions to meet compliance requirements
- Reducing latency by running agents closer to your users
- Deploying versioned agent updates across regions without disrupting live traffic
- Running different agent versions simultaneously across regional runtimes
Prerequisites
To package and deploy agents, you must have one of the following roles:
- Agent Garden Administrator
- Agent Garden Developer
- A custom role with privileges (Agent Garden Access, Agent Create, Agent Edit, Agent Feedback Submit, Agent Garden Feedback View)
Refer to Agent Garden for details on adding roles and setting up custom privileges.
You also need an environment that has a runtime cloud attached. The default Agent Garden Production environment has one attached as a starting point. To attach a runtime cloud to another environment, you must have the Agent Garden Developer role. Refer to Attaching and detaching an agent runtime cloud.
Important considerations
- If your agent uses your own model, you can deploy it only to the environments you selected on the model connection. Refer to Connecting models to Agentstudio.
- Each environment runs one package version at a time. Deploying a new version to an environment replaces the version currently running there.
Deploy your agent
Follow these steps the first time you deploy an agent and any time you edit an agent and want to deploy a new version. Editing an agent does not affect active deployments.
- Navigate to Agentstudio > Agent Garden > Agents and open your agent.
- In the Review tab, select Create.
- Select Package & Deploy. To create a package and deploy it later, select Package instead. Packaged agents appear on the Packages and Deployments > Packages page.
- Select the Environment that has the runtime cloud where you want the agent to run.
- Select Create Package & Deploy. Agentstudio assigns the package version number.
After you deploy
What users can do with your agent depends on its mode:
- Conversational agents: Users can chat with the agent in Agent Garden. Refer to Using AI agents. To add the agent to your own applications, use Boomi EmbedKit.
- Structured and Decision Engine agents: Use them in an integration process with the Agent step.
- Any agent mode: Add the agent to an integration process with the Agent step to create an agentic workflow. Refer to Configuring the Agent step.
Next steps
- Refer to Managing agent packages and deployments to deploy a package to another environment or roll back to a previous package.
- Refer to Disabling and deleting agent deployments to stop an agent from accepting requests or remove it from an environment.
- Refer to Agent runtime clouds and environments for the available regions and the IP addresses you may need to allow on your network.