Referenz & Datenmodell
Agent (agent)
Ein Agent ist ein eigener KI-Spezialist der Organisation: Anweisungen, Modell, Schrittlimit sowie zugeordnete Skills und MCP-Server.
Ein Agent bündelt eine feste Arbeitsanweisung mit einem Sprachmodell und den Werkzeugen, die er nutzen darf. Er wird als eigener Chat, als Subagent von Polaris, als Ziel einer Delegation oder aus einem Workflow (start.agent.<id>) ausgeführt. (Datenart: Konfiguration)
Wo in der App
Abschnitt betitelt „Wo in der App“Aligia AI › Agenten › Agents. Die Liste zeigt Status, Modell, Version, Max. Schritte, Skills und Server. Die Detailseite hat links Name, Beschreibung und Anweisungen, rechts „Properties“, Skills, MCP Servers und Tools. Neue Agenten entstehen im Gespräch mit Polaris oder über „Manual“. Siehe Guides › Agents.
| Feld | Technisch | Typ | Pflicht | Bedeutung | Besonderheit |
|---|---|---|---|---|---|
| Name | name |
Text | ja | Anzeigename, auch Name des Dienstkontos | Leerer Name blockiert Aktivierung |
| Beschreibung | description |
Text | nein | Wofür der Agent gedacht ist; Polaris nutzt sie zur Auswahl von Subagenten | Markdown |
| Anweisungen | initial_instructions |
Text | nein | Systemanweisung des Agenten | Markdown; Platzhalter „Initial instructions“ |
| Status | status |
Auswahl | ja | „Aktiv“ / „Inaktiv“ | Nur Admin; nur per Serverfunktion änderbar, Standard „Inaktiv“ |
| Verwendung | usage |
Auswahl | ja | „Haupt“ (main), „Subagent“ (subagent), „Beides“ (both) |
Standard „Haupt“ |
| Modell | model |
Auswahl | ja | Plattformmodell oder Modell eines eigenen LLM-Anbieters | Nicht mehr erlaubte Modelle erscheinen als „(unsupported)“ |
| Version | version |
Text | ja | Freie Versionsangabe | Standard „1.0“ |
| Max. Schritte | max_steps |
Zahl | ja | Obergrenze der Schritte je Lauf | Standard 10 |
Beziehungen
Abschnitt betitelt „Beziehungen“| Zu | Art | Pflicht | Beim Archivieren | Beim Löschen |
|---|---|---|---|---|
Agenten-Skill (agent_skill_map) |
n:m | nein | bleibt | Zuordnung mitgelöscht |
MCP-Server (agent_mcp_server_map) |
n:m | nein | – | Zuordnung mitgelöscht |
Dienstkonto (app_user) |
gehört zu (1:1) | nein | – | Agent mitgelöscht, wenn Konto gelöscht |
Unterhaltung (agent_conversation) |
hat viele | nein | – | Verweis bleibt; gelöschter Agent ist nicht mehr ausführbar |
Zuordnungstabellen
Abschnitt betitelt „Zuordnungstabellen“agent_skill_map und agent_mcp_server_map enthalten nur die beiden Verweise. Sie werden über „Skill hinzufügen“ und „MCP-Server hinzufügen“ auf der Detailseite gepflegt. Das Entfernen einer Zuordnung braucht eine Online-Verbindung.
Zustände
Abschnitt betitelt „Zustände“| Wert | Label | Übergang |
|---|---|---|
inactive |
Inaktiv | Standard nach Anlegen. Deaktivieren setzt das Dienstkonto auf inaktiv. |
active |
Aktiv | Nur Owner/Admin. Voraussetzung: Name nicht leer, Modell erlaubt. Legt beim ersten Mal das Dienstkonto an. |
Ein Nicht-Admin erhält beim Umschalten die Meldung, dass ihm die Berechtigung fehlt.
Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- Nur aktive Agenten mit Verwendung „Subagent“ oder „Beides“ bietet Polaris als Subagenten an (maximal 12, alphabetisch).
- Beim Laden eines Agenten für einen Lauf zählen nur Skills mit Status „Aktiv“ und nur Tools mit Berechtigung „Allow“ von Servern mit Status „Katalog verfügbar“.
- Der Abschnitt „Tools“ der Detailseite listet alle Tools der zugeordneten Server, unabhängig von deren Berechtigung.
- Agenten können nicht archiviert werden, nur gelöscht oder dupliziert.
Siehe auch
Abschnitt betitelt „Siehe auch“Agenten-Skill · MCP-Server · LLM-Modell · Unterhaltung · Dienstkonten