FruxonDocs

Agents

How agents work in Fruxon — anatomy, lifecycle, and the building blocks

An agent in Fruxon is one definition with everything attached: a model, prompts, tools, knowledge, memory, and revision history. You edit it as a form in Studio. On each run it reads its input, calls tools until it has an answer, and replies — and it can consult or escalate to a person along the way.

Anatomy of an agent

PieceWhat it is
InstructionsThe system prompt and input prompt you write in Studio.
ParametersTyped inputs the agent accepts at run time.
ModelThe LLM config and model the agent runs on, plus fallback providers.
ToolsWhat the agent can do — call APIs, query DBs, run code, send messages.
Knowledge BaseDocuments and data sources retrieved at runtime.
MemoryPersistent facts the agent reads and writes.
Agent NetworkTriggers and participants that can deliver messages, events, and approval work to the agent.
RevisionsImmutable snapshots — every saved version is recorded.
BudgetsDaily, weekly, and monthly spend limits, with alert thresholds.

The agent page

Opening an agent shows its page, with these tabs. You build the agent itself in Studio.

TabWhat it shows
OverviewThe agent's dashboard: how it's wired, and cards for cost, quality, and activity over a time range you pick.
EnvironmentsThe customers or locations this agent serves, one environment each. See Environments.
InboxEverything waiting on a person for this agent, in four folders: Escalations, Approvals, Questions the agent parked for a teammate, and Access requests from senders not yet on its roster.
MemoryWhat the agent remembers, shared and per person. See Memory.
ConversationsThe people the agent talks to, their channels and topics, and each transcript. See Conversations.
ExecutionsEvery run, with its trace. See Observability.
ImprovementsChanges a reviewer suggests after reading the agent's conversations. Admins only. See Improvements.

The agent lifecycle

  1. Create — name, type, description.
  2. Build — write its instructions and pick its model in Studio.
  3. Equip — wire AI providers, tools, knowledge, memory.
  4. Test — run interactively with sample inputs (Testing).
  5. Evaluate — score candidate revisions against a golden dataset (Evaluations).
  6. Deploy — promote a revision to production (Versioning).
  7. Connect — add API callers, Agent Network triggers and participants, or workflows that run it.
  8. Operate — watch traces, review conversations, act on improvements, manage costs.

Agent types

The type field is a label that helps organize agents and provides sensible defaults — it doesn't restrict capability. Pick whichever fits.

  • Chat — multi-turn conversational agents (support, Q&A, copilots).
  • Summarization — turn long content into briefings or digests.
  • Recommendation — score, rank, or suggest based on inputs.
  • Analyzer — process data and generate insights.
  • Other — anything else.

Any type can have any tools and any settings. Type is metadata, not a runtime gate.

What's in this section

On this page