DocsDocs

Konzepte

Konzepte

Die wichtigsten Plattformkonzepte von Mandanten bis Watchdog, mit ehrlichem Status für Vorschau und geplante Bereiche.

Status

Mandanten und Rollen

Ein Mandant ist die Grenze für Daten, Rollen, Richtlinien und Kosten. Die Plattform überträgt den Mandantenkontext mit jeder Anfrage. Row-Level-Security ist als Vorschau markiert, weil der Rollout und einzelne Wartungsrollen eigene Einschränkungen haben.

Rollen kommen nicht aus dem Body einer Anfrage, sondern aus verifizierten Sitzungen, API-Schlüsseln oder gespeicherten Mitgliedschaften. Plattformweite Sichten sind Plattform-Admins vorbehalten.

Agenten

Agenten sind versionierte Einheiten mit Persona, Modell, Werkzeugen, Wissen und Governance-Kontext. Freigabe-Gates bewerten die aktuelle Version. Ältere Versionen werden laut Statushinweisen nicht als Snapshot ausgeführt.

Agent-Teams

Open Agent Team organisiert Agenten in Firmen, Teams und Räumen. Board-Freigaben, Tool-Freigaben, Kostenrollen und Team-Vorlagen sind getrennt belegt. Einige Team-Funktionen sind verfügbar, einige Vorschau und einige geplant.

Open Bot

Open Bot ist der Chat-Zugang für Mitarbeitende. Er nutzt die freigegebenen Agenten eines Mandanten, Räume und Kanäle. Web-Chat und API-Kanäle sind verfügbar, andere Kanäle haben eigene Statuswerte.

Wissen und RAG

Wissensbasen liefern Quellen für Antworten. SharePoint ist als Wissensquelle Vorschau, weil die Tests gegen lokale Microsoft-Graph-Mocks laufen und ein echter Microsoft-365-Mandant noch nicht belegt ist. Berechtigungen und Quellen bleiben deshalb ein eigener Prüfungspunkt.

Werkzeuge und Verbindungen

Connections bündeln OAuth, Tokenablage, Egress-Regeln, Reauth und Verbindungsstatus für Anbieter wie GitHub, GitLab, Microsoft 365 und weitere Definitionen im Paket @oap/connections. Das Feature ist teilweise hinter Flags wie OAP_CONNECTIONS_ENABLED beschrieben.

Ticket-On-Ramps verbinden Jira, Linear oder Asana mit Agent Teams. Der Runbook-Pfad beschreibt Pausen, Webhook-Gesundheit, Circuit Breaker und Wiederherstellung.

Modelle und Gateway

Das Gateway verwendet LiteLLM und Modellregistrierungen. Routing priorisiert Datenresidenz und dann Kosten. Modellqualifikation, Residency-Tags und tenantgebundene Gateway-Schlüssel sind getrennte Konzepte.

Governance und Audit

Governance umfasst Guardrails, Budgets, Audit-Log, Evidenzketten, Freigaben und API-Schlüssel. Der Audit-Log ist verfügbar. Einige fortgeschrittene Nachweise wie DSAR-Ausführung, Tenant Export oder Lebenszyklus-Abläufe sind Vorschau und müssen mit ihren Einschränkungen gelesen werden.

Coding-Agents

Coding-Runs führen einen Coding-CLI in einer Sandbox oder optional über einen lokalen Worker aus. Der Host validiert das Bundle, prüft Pfade, Größe, Geheimnisse und Fast-Forward, und pusht erst nach einer Freigabe. Der lokale Worker ist laut Contract gebaut, aber standardmäßig deaktiviert.

Watchdog

Watchdog ist die Geräte- und Kontrollschicht für lokale Coding-Agenten. Der Contract beschreibt API-Key-Scope, Gerätesignatur, Heartbeat, Task-Angebot, Claim und Upload. Viele Worker-Funktionen sind durch Flags deaktiviert und dürfen nicht als allgemein verfügbar beworben werden.

Grundlage im Repository
  • docs/product/features.yaml
  • docs/platform/agent-teams.md
  • docs/platform/connections.md
  • docs/platform/coding-runs.md
  • docs/platform/watchdog-worker-contract.md

Concepts

Concepts

The core platform concepts from tenants to Watchdog, with honest status for preview and planned areas.

Status

Tenants and roles

A tenant is the boundary for data, roles, policy and cost. The platform carries tenant context with every request. Row-level security is marked preview because rollout and selected maintenance roles have explicit limits.

Roles are not trusted from a request body. They come from verified sessions, API keys or stored memberships. Cross-tenant platform views are reserved for platform admins.

Agents

Agents are versioned entities with persona, model, tools, knowledge and governance context. Release gates evaluate the current version. Older versions are not executed as snapshots according to the status notes.

Agent teams

Open Agent Team organizes agents into companies, teams and rooms. Board approvals, tool approvals, cost roles and team templates are separately tracked. Some team features are available, some are preview and some are planned.

Open Bot

Open Bot is the chat entry point for employees. It uses the approved agents of a tenant, rooms and channels. Web chat and API channels are available, while other channels carry their own status values.

Knowledge and RAG

Knowledge bases provide sources for answers. SharePoint is a preview knowledge source because tests run against local Microsoft Graph mocks and a real Microsoft 365 tenant is not yet evidenced. Permissions and citations remain a dedicated review point.

Tools and connections

Connections combine OAuth, token storage, egress rules, reauthorization and connection status for providers such as GitHub, GitLab, Microsoft 365 and other definitions in @oap/connections. Parts of the feature are described behind flags such as OAP_CONNECTIONS_ENABLED.

Ticket on-ramps connect Jira, Linear or Asana to agent teams. The runbook covers pause controls, webhook health, circuit breakers and recovery.

Models and gateway

The gateway uses LiteLLM and model registrations. Routing prioritizes data residency and then cost. Model qualification, residency tags and tenant-bound gateway keys are separate concepts.

Governance and audit

Governance covers guardrails, budgets, audit log, evidence chains, approvals and API keys. Audit log is available. Advanced evidence flows such as DSAR execution, tenant export or tenant lifecycle are preview and must be read with their limitations.

Coding agents

Coding runs execute a coding CLI in a sandbox or optionally through a local worker. The host validates the bundle, paths, size, secrets and fast-forward state, and pushes only after approval. The local worker is built according to the contract, but disabled by default.

Watchdog

Watchdog is the device and control layer for local coding agents. The contract describes API-key scope, device signature, heartbeat, task offer, claim and upload. Many worker functions are gated by flags and must not be promoted as generally available.

Repository sources
  • docs/product/features.yaml
  • docs/platform/agent-teams.md
  • docs/platform/connections.md
  • docs/platform/coding-runs.md
  • docs/platform/watchdog-worker-contract.md