DocsDocs

Start

Schnellstart

Zwei Wege zum ersten Ergebnis: Managed mit SSO und Open Bot, oder Self-hosted mit install.sh auf einem bestehenden Kubernetes-Cluster.

Status

Managed: erster Agent und erster Chat

Der Managed-Pfad ist für Umgebungen gedacht, in denen der Betreiber die Plattform bereitstellt und Nutzerinnen über SSO einsteigen. Die Statusquelle führt Managed Cloud als eigene Funktion, deshalb bleibt der Rolloutstatus sichtbar.

  1. 1

    Melde dich über den vom Betreiber konfigurierten OIDC- oder SSO-Zugang an.

  2. 2

    Wähle deinen Mandanten und prüfe, ob deine Rolle Agenten erstellen darf.

  3. 3

    Erstelle einen Agenten mit Persona, Modell und optionalen Werkzeugen.

  4. 4

    Öffne Open Bot und starte einen Chat mit diesem Agenten.

  5. 5

    Prüfe im Status oder in Governance, ob Freigaben, Budget oder Guardrails für den Agenten greifen.

Self-hosted: bestehender Kubernetes-Cluster

Der Self-hosted-Pfad nutzt das vorhandene Cluster des Betreibers. Das Cloud-Paket beschreibt ausdrücklich, dass es keinen Cluster, keine Node Pools, keine DNS-Zone und keinen Bucket provisioniert.

  1. 1

    Stelle ein Kubernetes-Cluster ab Version 1.28 mit StorageClass, Ingress, DNS, Secret-Verwaltung und Backup-Ziel bereit.

  2. 2

    Lege eine private site.env außerhalb des Repositorys an und setze Hostname, Namespace, StorageClass, Backup-Ziel und Image-Registry.

  3. 3

    Prüfe die Eingaben mit infra/cloud/lib/install.sh --target eu-k8s --kubeconfig /pfad/kubeconfig --env /pfad/site.env --check-env.

  4. 4

    Installiere mit demselben Skript ohne --check-env, wenn die Prüfung sauber ist.

  5. 5

    Verifiziere Login, Chat, Streaming, PVCs, Ingress, TLS und Restore-Probe nach dem Installationsrunbook.

bash
infra/cloud/lib/install.sh --target eu-k8s \
  --kubeconfig /secure/oap/kubeconfig \
  --env /secure/oap/site.env --check-env

Was du danach lesen solltest

  • Konzepte für Mandanten, Rollen, Wissen, Modelle und Governance.
  • API-Referenz für öffentliche Endpunktfamilien.
  • Betrieb für Exoscale SKS, Multi-Cloud und Backup.
Grundlage im Repository
  • README.md
  • infra/cloud/README.md
  • charts/oap/README.md
  • docs/product/features.yaml

Start

Quickstart

Two ways to a first result: managed with SSO and Open Bot, or self-hosted with install.sh on an existing Kubernetes cluster.

Status

Managed: first agent and first chat

The managed path is for environments where the operator provides the platform and users enter through SSO. The status source tracks Managed Cloud as its own feature, so the rollout state remains visible.

  1. 1

    Sign in through the OIDC or SSO entry point configured by the operator.

  2. 2

    Select your tenant and check whether your role may create agents.

  3. 3

    Create an agent with persona, model and optional tools.

  4. 4

    Open Open Bot and start a chat with that agent.

  5. 5

    Check status or governance to see whether approvals, budget or guardrails apply to the agent.

Self-hosted: existing Kubernetes cluster

The self-hosted path uses the operator's existing cluster. The cloud package states explicitly that it does not provision a cluster, node pool, DNS zone or bucket.

  1. 1

    Prepare a Kubernetes cluster version 1.28 or newer with StorageClass, ingress, DNS, secret management and a backup target.

  2. 2

    Create a private site.env outside the repository and set host name, namespace, StorageClass, backup target and image registry.

  3. 3

    Check inputs with infra/cloud/lib/install.sh --target eu-k8s --kubeconfig /path/kubeconfig --env /path/site.env --check-env.

  4. 4

    Install with the same script without --check-env when the check is clean.

  5. 5

    Verify login, chat, streaming, PVCs, ingress, TLS and a restore probe after the install runbook.

bash
infra/cloud/lib/install.sh --target eu-k8s \
  --kubeconfig /secure/oap/kubeconfig \
  --env /secure/oap/site.env --check-env
  • Concepts for tenants, roles, knowledge, models and governance.
  • API reference for public endpoint families.
  • Operations for Exoscale SKS, multi-cloud and backup.
Repository sources
  • README.md
  • infra/cloud/README.md
  • charts/oap/README.md
  • docs/product/features.yaml