Quick start: Vibe code agents
This guide will show you how to build your first agent with the Toolhouse Agent Studio
Navigate to agent studio here. Then press “create a new agent”.
You will find a chatbot like interface like this
Step 1: Describe your agent
In the chat box you can describe what you want the agent to do, Toolhouse will write the agent for you. Make sure you are specific with your demands.
Channel your inner prompt engineer
Example of prompts (with breakdown)
GOOD PROMPT
Build an agent that searches x for positive, negative, and neutral mentions about my product. The agent should give me a nice report and ask it if i want the report sent via email.
Why it’s good:
Specific task (search for sentiment mentions about a product)
Clear outputs (report, sentiment analysis)
Defined interaction (ask about emailing)
Useful for automation or monitoring
BAD PROMPT
Build an agent that finds competitors helps me with my business.
Why it’s bad:
Too vague: finding competitors is a good start, but being specific could be better (search x, what type of competitors are you looking for”
Undefined scope: What kind of business help? Marketing, sales, operations?
No clear task or output: There’s no goal, input, or expected result.
Large Scope “ finding competitors” will bring inconsistent results due to the wide scope the agent will search
No one was born a prompt-engineer on their first day.
Have a natural conversation with your agent, and add as many details as you can.
Give your agent an exit strategy
Tell your agent what it should do or should not do
Give your agent a tone, a voice, a personality if you need
Step 2: Run your agent
Once you've prompted your agent to your satisfaction you can run it to see how it responds
When you run the agent it will reply to your first message (which you can see at the bottom of the YAML file, usually after system_prompt)
The message is what the agent will use as instructions when it runs the first time you press the ▶ Run button
Step 3: Deploy your agent
If the agent you built is satisfactory, press deploy to make it live.
If not, then you can continue chatting with the agent studio to refine it.
At any point you can press 🔼 Deploy, and you will get a API endpoint you can use.
You can send a POST requests to it.
You can find this endpoint under the Agents API tab (see screehot below)
Step 4: Integrating your agent
What to do after deployment?
When your agent has been deployed you can start using your Agent immediately.
1) Deploy
Under Deploy you will get a link where you can interact with your agent.
Once you click it you will be redirected to an Agent interface where you can interact with your agent, just like ChatGPT, and make sure you are getting the correct outputs.
Here is sample JavaScript code to use in your project to call your agent and print out the result. Just replace the variable urlwith the link to your agent
const url = "https://agents.toolhouse.ai/d9e32c6c-accd-4e24-a1ae-0c7614770733";
const headers = {
"Content-Type": "application/json", // "Authorization": "Bearer YOUR_API_KEY" // Uncomment if needed };
const data = {
input: "Hello, Toolhouse agent!" // Replace with your actual payload
};
fetch(url, {
method: "POST",
headers: headers,
body: JSON.stringify(data)
}).then(response => {
if (!response.ok) {
throw new Error(HTTP error!Status: $ {
response.status
});
}
return response.json();
}).then(result => {
console.log("✅ Success! Response:");
console.log(result);
}).catch(error => {
console.error("❌ Request failed:", error);
});2) Schedule your Agent
If you need to have agents run at certain intervals, you can go to the Schedule tab
All you need to do from here is set a schedule for your agent to run and click create schedule
Examples of agents you can schedule
Find me trending AI events in SF and send me an email at x.gmail.com
3) Lovable/Bolt - Vibe code your front-end
Navigate to the Lovable or Bolt tab under agent deployment, then press the clipboard icon to copy the prompt. Then paste this into lovable.
press enter and you will get something like this! you can continue to build your project from there with lovable, but your backend is now up and running!
Get Help
You can find help from our AI support agent live: our help chatbot can answer any questions.
Alternatively you can join us on Discord where a member of the community will surely answer, get you unlocked and/or provide support!
Happy agent building!
Last updated