Skip to content
Rival Docs

Building with RivalBot

What is RivalBot

RivalBot is the AI assistant inside Studio (/studio). Instead of starting from a blank editor, you describe what you want in natural language and RivalBot generates a working tool - code, input schema, test cases, metadata, and icon - then hands it to you in the Tool Editor for review and publish.

You’ll also see RivalBot inside the Tool Editor itself, where you can chat to edit an existing tool.

Building a tool from Studio

  1. Sign in at cortexone.rival.io and open Studio from the sidebar.
  2. In the “What do you want to build?” prompt, describe your tool.
  3. Answer any clarifying question RivalBot asks.
  4. Wait for it to finish generating - you’ll land in the Tool Editor with everything pre-filled.

Example prompts:

  • “A tool that takes a URL and returns the page’s title and meta description.”
  • “Summarize a CSV by computing column-level stats and returning the top 5 outliers.”
  • “Tag incoming customer emails by sentiment and urgency.”

RivalBot streams status messages while it works - “Thinking…”, “Generating code…”, “Generating documentation, metadata, events & icon…”, “Creating tool…” - and asks a clarifying question if your prompt is ambiguous instead of guessing.

When it’s done, the Tool Editor opens at the Basic Info step with code, test cases, branding, overview, and documentation already drafted. Walk through the six steps to review and adjust, then publish.

Editing an existing tool

Open any tool you own and you’ll see a RivalBot chat panel inside the Tool Editor. Use it to iterate without leaving the page.

Common quick actions:

  • “Improve the code”
  • “Add error handling”
  • “Write tests”
  • “Explain logic”
  • “Debug this error”
  • “Generate documentation”
  • “Generate a changelog”

RivalBot can update any part of the tool - code, test cases, metadata, documentation, icon - based on what you ask. Conversation history is preserved per tool, so you can come back later and pick up where you left off.

RivalBot finds existing tools

Before generating new code, RivalBot searches the Tools Marketplace for tools that already do what you’re asking. Two behaviors result:

Build pre-check

When you ask RivalBot to build something that already exists, it surfaces matching marketplace tools first as cards. You choose:

  • Use existing - adopt the existing tool into your org
  • Build anyway - keep going with the build

This saves time and avoids reinventing tools the community has already published.

Inline tool execution in chat

When you’re chatting with RivalBot about something that doesn’t need a build at all - for example “Give me the latest AI news” - RivalBot may call a marketplace tool directly inside the conversation and stream the result back. You’ll see a tool-call card showing:

  • Tool name
  • Input arguments while running
  • Output when complete

Status is one of Success, Failed, or Insufficient balance (the last one routes you to your wallet).

RivalBot may also show a Related tools chip row below its replies - marketplace tools that matched but weren’t called. Click one to open its detail page.

Status messages

Some of the status lines you’ll see and what they mean:

StatusMeaning
”Thinking…”RivalBot is figuring out what to do.
”Generating code…”Writing the handler code.
”Improving code…”Refactoring or fixing existing code.
”Debugging code…”Investigating an error you reported.
”Generating test cases…”Creating example events you can run against your tool.
”Updating metadata…”Editing the tool’s category, sectors, tags, etc.
”Generating documentation…”Writing or rewriting the tool’s docs page.
”Generating changelog…”Drafting release notes from your changes.
”Checking marketplace…”Looking for existing tools that already solve this.
”Analyzing requirements…”Breaking your prompt down before building.

Tips for working with RivalBot

  • Start specific. “A tool that takes X and returns Y” is faster than “Something to help with marketing.”
  • Iterate in small chunks. Ask for one change at a time so you can see what RivalBot did and easily revert.
  • Test as you go. Every change is also reflected in test cases - run them from the Test panel to make sure the tool still works.
  • Don’t worry about the first draft. RivalBot’s output is a starting point. Edit by hand or by asking RivalBot to update it.

Next steps