Skip to content

Reference & Data Model

Conversation (agent_conversation)

A conversation is a private chat with Polaris or an agent, with title, model, reasoning budget and read status.

The conversation holds the frame of a chat: who is having it, which agent answers, which model and which reasoning budget apply. The conversation history itself lives in engine stores and is displayed via the chat. Every conversation is bound to a chat run (Execution with trigger „Chat“). (Data type: private runtime data)

Aligia AI › Polaris with the list „Unterhaltungen“ (Conversations) („Angepinnt“ (Pinned), „Zuletzt“ (Recent)), the chat and the „Seitenleiste“ (Sidebar) („Dateien“ (Files), „Aufgaben“ (Tasks), „Agenten“ (Agents)). Also „Frage Polaris“ (Ask Polaris) in the sidebar, „Polaris fragen…“ (Ask Polaris…) in the search and the „Agent-Protokoll“ (Agent log) on delegated issues and tasks. See Guides › Polaris.

Field Technical Type Required Meaning Notes
Title title Text no display name; „(ohne Titel)“ (untitled) while empty the system generates it after the first message; „Umbenennen“ (Rename) overwrites it
Agent agent_id Reference no empty = Polaris; otherwise the chosen agent („Mit Agent chatten“ – Chat with agent) fixed from creation
Model model Selection no platform model or own LLM model empty = organization default; locked after the first send
Reasoning budget reasoning_effort Selection no „Auto“, „Aus“ (Off), „Niedrig“ (Low), „Mittel“ (Medium), „Hoch“ (High), „Sehr hoch“ (Very high), „Maximal“ (Maximum) empty = platform default
Last activity last_turn_at Date no last message or reply; list sort order System
Unread – (from last_read_at) Yes/No – blue dot if there is activity newer than last read System; opening marks as read
Pinned pinned_at Date no top of the list, most recently pinned first „Anpinnen“ (Pin) / „Lösen“ (Unpin)

Not visible: engine state, token consumption as raw data, task list as raw data (the sidebar shows its content).

Related to Kind Required On archive On delete
Agent belongs to no – reference kept; chat with a deleted agent can no longer be continued
Execution (chat run) belongs to (via engine run) no – on deleting the conversation all its stores are cleared
  • In the input field: / skills, @ agents, # Aligia objects; attach files. Images are only sent to models with „Akzeptiert Bild-Eingaben“ (Accepts image input).
  • Polaris acts with the user’s permissions and can create comments, tasks and issues. Own agents only read Aligia data.
  • Delegated conversations (issue/task „Delegieren“ – Delegate) run under the agent’s service account; whoever may read the issue sees the agent log but can neither rename, pin nor delete the conversation.

Agent · Execution · Private data · Issue