Quickstart
Build, test, and ship your first agent in five minutes
This walkthrough takes a brand-new account from zero to a working, deployed agent. You'll build a simple research assistant that takes a topic and returns a structured briefing.
Don't have an account yet? Sign up at fruxon.com — it takes about a minute. The free tier covers everything in this guide.
Before you start
You'll need:
- A Fruxon organization (create one)
- An API key from at least one LLM provider (OpenAI, Anthropic, or Google work fine — the cheapest model is plenty for the demo)
Connect an AI provider
Open LLM providers in the sidebar (or jump straight in via Studio later). Paste a key from your provider's dashboard. The key is encrypted at rest and never leaves your organization.
You can connect more than one provider and give each agent the model that suits it — a fast cheap one for a simple classifier, a strong one for an agent that writes careful answers.
Create your first agent
Every agent belongs to an Application. Open your Application's Agents page and click New Agent. The dialog asks for:
- Name — Research Briefing
- Application — the Application the agent belongs to. With only one Application, it's picked for you; with several, it starts on the one you're in.
Click Create agent. You land in Studio, where you configure the agent.
Configure the agent
An agent is one form: what it takes in, what it's told to do, and which model does the work. Fill in two groups:
- Instructions
- Parameters — click Add parameter:
- Name:
topic - Type:
STRING - Required: ✓
- Name:
- System Prompt:
You are a research analyst. Write concise, factual briefings. - Input Prompt:
Write a one-page briefing on: {{param.topic}} Include: background, key players, recent developments, why it matters. Use short paragraphs. No fluff.
- Parameters — click Add parameter:
- Model & capabilities — under LLM Config, pick the provider you connected, then a Model.
Insert {{param.topic}} from the prompt editor's placeholder menu. On each run, Fruxon fills it with the run's topic, and the model's reply is what the agent returns. Studio saves your edits as you go.
Test it
Use Test chat on the right. Pick Single run, fill topic with something — "the EU AI Act" — and run.
You'll see:
- The model's response, streamed live
- A full trace showing prompts, tokens, latency, cost
- Any error context if something went wrong
Iterate freely. Your edits stay in a draft until you deploy, so nothing you try reaches production.
Deploy
Happy with it? Click Deploy. Say in a line why you're making the change; Fruxon saves the draft as a new version (a revision), runs its pre-deploy checks, and makes it live. The deployed revision is what API calls, triggers, and participant-routed messages will hit. To roll back, deploy a previous revision — there's no downtime.
Call it from anywhere
Your agent is now reachable three ways:
- REST API —
POST /v1/{tenant}/agents/{agent}:executewith a Fruxon bearer token. See the API reference. - Python SDK —
pip install fruxon. See the SDK guide. - Agent Network — Bind Slack, Teams, Telegram, Twilio, or other provider channels to participants, and bind those participants or triggers to the agent. See Agent Network.
Where to go next
Add tools
Let your agent call APIs, query databases, run code, and use skills.
Add knowledge
Upload files or connect Confluence, GitHub, web sources for retrieval.
Test rigorously
Run candidate revisions against golden datasets before you deploy.
Watch it run
Traces, costs, errors, and per-step breakdowns for every execution.
Rather build from your editor? Install the Fruxon plugin for Claude Code or Codex and describe the agent you want; it drives the CLI to build, test, and deploy it.
Got stuck? See the troubleshooting guide, or restart the in-app product tour from the Help menu.