Building an App

The creation wizard

Click New App (on the Apps page, or in the Library's Create menu). The wizard walks four steps:

1. Welcome - what an App is and what's ahead.
2. Supervisor - pick an existing Agent or name a new one (created as a draft you'll shape later).
3. Orchestration - choose what the Supervisor may route to: Agents, Flows, both, or nothing (Supervisor answers alone). Then select existing members or name new ones; new names are created as drafts.
4. Identity & Goals - name, description, and goals, all required. AI Generate drafts all three from the Supervisor and members you actually picked.

Finish creates everything and drops you into the editor. Nothing in the wizard is final - it's all editable on the canvas.

The canvas

The editor's Design tab shows the App as a vertical hierarchy: the App node on top, the Supervisor below it, and the Orchestrates band underneath. Drag the dotted background to pan.

• Add members - drag Agents and Flows from the left palette into the band. The dashed "New Agent" / "New Flow" palette items create a fresh draft on drop.
• Swap the Supervisor - drag any Agent onto the Supervisor slot. Only Agents can lead an App; the replaced Supervisor is not added to the band. Dragging a band Agent onto the slot promotes it out of the band.
• Reorder - drag members within the band; remove with the x that appears on hover.
• App settings - click the App node for name, description, goals, and the orchestration mode.
• Supervisor drawer - click the Supervisor for its app-scoped Orchestration & synthesis instructions (stored on this App, not on the Agent) and a remove action.
• Get Info - the hover info button on the Supervisor or any member shows its role, model, knowledge, and how many Apps use it, plus Open in editor - a deep link into the Agent or Flow editor with a breadcrumb back to the App.

Members are shared building blocks: editing one in its own editor changes it everywhere it's used. Knowledge, services, and connectors live inside each Agent, not on the App.

Everything autosaves as you work.

The preview chat

The right rail is a live chat running the draft App - latest members, latest instructions. Use it to test routing as you compose: ask something open-ended and watch the Supervisor answer; ask for something a member owns and watch it delegate.

Publishing (the Mode tab)

The Mode tab controls how the App ships:

• Publish freezes the current composition: the Supervisor's published version, every orchestrated member's published version, and the App's API contract are pinned into the release. If the Supervisor or a member has no published version yet, publishing blocks with a list of what to publish first.
• Republishing a member later does not change a published App - republish the App when you want it to pick up new member versions. Drafting always stays live.
• Visibility - the public/private toggle, same as any other tool.

The API tab

Configure the App's External API surface:

• Conversation Service - on by default; set the greeting that opens a session.
• Transaction Service - opt-in; define the input and output JSON Schemas the typed endpoint enforces.

The API always serves the published contract - republish after changing this tab. Calls authenticate with your organization's API keys (fw_live_...) using the apps:read / apps:execute scopes.

The Monitor tab

Last-30-days health at a glance: runs, unique users, credits, API spend, completion rate, error rate, and average run time, with a run trend chart. Full analytics opens the App's drill-down - every run in range, each one replayable step by step.

Billing

An App run bills as one execution at the Supervisor's model rate, exactly like an Agent run - member calls inside the run don't create extra charges. Apps are included on every plan.