Quickstart - Bubble.io
You can go from zero to a working AI agent inside your Bubble app in under 15 minutes. This guide walks you through creating an account, wiring your agent into your application, and sending your first message.
Set Up Your Agent
-
Create your account
Sign up at pluto-agent.com. This gives you access to your developer portal, where you'll manage keys, credits, and your agents.
-
Generate an API key
From the portal, open API Keys and generate a new key. This key authenticates every request your app makes to the agent.
Treat your API key like a password. Store it somewhere safe and never commit it to a public repository or expose it in client-side code you don't control.
-
Create an agent and deploy it to Test
Open Agent Studio and click New Agent. You'll land straight in the editor for a brand-new agent.
There's nothing to configure yet—press DEPLOY AGENT beside Test to deploy the empty configuration as-is.
While you're here, copy the Agent ID shown at the top of the editor—it's the letters
pa-followed by six digits. Your app will include that ID with every request it sends.Your agent only starts answering requests in an environment once you've deployed to it, so this first deploy is what makes it reachable.
-
Download the Pluto Agent plugin on Bubble
Install the Pluto Agent plugin from the Bubble plugin marketplace.
Coming soon
The plugin listing isn't public just yet. This link will point to the live marketplace page the moment it's available.
-
Configure the plugin with your API key
In the plugin's settings, paste your API key into the API Key field. Enter it in the
Bearertoken format shown below—the wordBearerand the space before your key are both required:API Key field -
Wire up the Response-Agent-API in your workflow
Add the plugin's Response-Agent-API action to whichever workflow should talk to your agent (for example, when a user clicks Send). This action carries the client's message to your agent and returns the agent's response.
To point it at the agent you just deployed: pass the Agent ID you copied in step 3, and set the environment to
test. See the Response-Agent API reference for every field the action sends.For a conversational AI Agent, you design the interface yourself—chat bubbles, input box, send button, and how the response is displayed are all yours to build. The plugin handles communication with your agent; you own the look and feel.
-
Send your first message
Preview your app, type a message, and send it. Your agent will plan, decide, and respond.
Congratulations—you've just set up your AI agent. 🎉🎉🎉
Your Agent Is Still Empty
The agent you deployed is fully functional, but its configuration is blank, so it behaves generically. Now it's time to configure it.
Agent Studio is where you build your AI Agent:
- Agent Purpose and Instructions — what is it for, and how should it behave.
- Agent Guardrails — rules it must always follow.
- Agent Model — the brain that powers reasoning, planning and responding.
- Tools — the capabilities it is allowed to use.
Start with Basic Configuration to set up your Agent Build.
An Agent Build is the set of configurations that make up your AI Agent.
Each agent you build has an associated Agent Build.
Going Live
Everything so far has run in your Test environment.
The Test environment is for prototyping and testing.
Once testing is complete, you deploy your agent to Live environment.
When you're happy with how your agent behaves, deploy it to Live in
Agent Studio and switch your Bubble app's Response-Agent-API action to
environment: live.
Your Test environment keeps working exactly as it is, so you can carry on making changes without touching what your users see.