astrion-website/content/en/03-conversations.md

6.0 KiB

Conversations

This chapter covers the capabilities of "a single conversation" itself: conversation types, thinking mode, goal mode, and the panel features available during a conversation.


1. Conversation Types: Regular vs Multi-Agent

Chosen when creating a conversation and immutable after creation:

  • Regular conversation (agent): you converse with one main agent, which can spawn sub agents in the background as needed to get work done.
  • Multi-agent conversation: the main agent is fixed as a Team Leader, which does not do the work itself but instead creates multiple role-based sub agents (such as Full-Stack Engineer, UI Operator), assigning tasks among them, collecting reports, and making decisions. Sub agents can also communicate with each other, but every exchange is reported to the Team Leader in sync — there is no "backchannel collusion".

Where to switch: the conversation type selector to the right of + on the bottom row of the input bar when the conversation is empty; the sidebar's list filter determines which type of conversations you see in the list.

For the full multi-agent playbook, see the "Agent Capabilities" chapter.

2. Thinking Mode and Reasoning Effort

Two independent switches, both scoped to the current conversation:

  • Thinking mode: fast / thinking. Fast mode prioritizes response speed and skips the reasoning process; Thinking mode uses a reasoning model for the whole conversation. Switchable in the input bar; a default can be set in Personal Space.
  • Reasoning effort: a Default / Low / Medium / High slider (only appears when reasoning_effort: true is set in the model configuration). "Default" means no intensity is specified and the API's own default behavior is used; dragging the slider adjusts the reasoning depth level in real time.

A model's multimodal capability (whether it can send images/videos) is determined by the multimodal field of that model in custom_models.json; the available thinking mode options are determined by reasoning_capability.

3. Goal Mode (Beta)

⚠️ Goal Mode is a beta feature: the mechanics are fully usable, but edge cases (token accounting during concurrent conversations, recovery from abnormal interruptions, etc.) are still being polished. Please use it with these expectations in mind and report any issues.

In a regular conversation, the AI stops after completing the one round of tasks you assigned. Goal Mode makes the AI keep working round after round automatically toward a long-term goal, until the goal is achieved or the limit is hit.

How to use:

  1. In the input bar + menu → "Goal Mode", entering the "ready" state;
  2. Your next message is treated as a goal (rather than a regular task);
  3. The AI works continuously toward the goal: after each round it self-evaluates "is the goal achieved?", and if not, it proceeds to the next round;
  4. It stops when the goal is achieved, a limit is hit, or you cancel manually.

Stopping conditions (configurable in Personal Space, multiple selectable):

  • max_turns: at most N automatic additional rounds (has a default value, adjustable);
  • max_tokens: cumulative (input + output) token cap, disabled by default. Note that this figure is workspace-level and approximate when multiple conversations run concurrently.

Goal review: an optional goal-review agent (the goal_review entry on the "Review Agents" page in Personal Space) with two review modes:

  • readonly (default): the review agent reads the conversation content only to judge goal progress;
  • active: it is allowed to run read-only commands for evidence (for example, checking whether a file was actually generated) before drawing conclusions.

Goal state is persisted independently per conversation (goal_states/<conversation ID>.json); switching conversations, compressing context, or restarting the service never loses goal progress.

4. Conversation Panels: Recap / Usage / Live Terminal

Three panel-style features in the input bar + menu (they are information panels only and unrelated to the security mechanisms):

  • Conversation recap: opens a recap view of the current conversation, letting you review what was done in this conversation along a timeline.
  • Usage stats: a context and token usage panel showing the current conversation's context occupancy and cumulative consumption.
  • Live terminal: opens a live terminal panel where you can directly watch the terminal session the AI is currently executing — which command it is running and what the output is. This is an observation window, not a security boundary; for real security controls, see the "Execution & Security" chapter.

5. Conversation Management

  • Search: the search box at the top of the sidebar retrieves conversations by title and content.
  • Flat / Grouped views: the sidebar can lay out all conversations flat, or group them by workspace (Personal Space → "Appearance & Display" → sidebar grouping). In grouped mode, workspaces can be pinned and sorted.
  • Type filter: the type switcher in the sidebar (Regular / Multi-agent) determines which type of conversations appear in the list.
  • New conversation button behavior: configurable in Personal Space — clicking + either "navigates to a blank new conversation page" (route) or "immediately creates an empty conversation" (blank).
  • Auto title: enabled by default; a title is generated automatically after the first round. Can be disabled in Personal Space.

6. Conversation Display Modes

Personal Space → "Appearance & Display" provides three message-stream display modes:

  • Traditional list: all messages laid out flat;
  • Stacked animation: intermediate blocks such as tool calls are stacked and collapsed, keeping the main thread of the conversation cleaner;
  • Minimal mode (default): the most restrained display, showing only the essentials.

There are also "Full info / Condensed info" controls for how much condensed messages expand, as well as display switches such as the assistant's status avatar (give it a poke for an easter egg).