Access to a workspace
A workspace is your team’s isolated space for agents, runs, integrations, and members. Everything you create belongs to one.1
Get your workspace URL
Your Komodor contact provides it. It is also the base host for every API example in these
docs.
2
Sign in with SSO
Authentication goes through your identity provider — there is no separate password. First-time
access is provisioned as you sign in. See Signing in.
3
Confirm you have the right role
Reading runs, creating agents, and managing access are separate permissions. If a screen or
action appears locked, your role does not grant it — see Roles & permissions.
At least one connected system
An agent with no access can reason but cannot observe or act. Connect one system before your first real run — the one whose data you actually want an agent looking at.
Start with Integrations overview to see the
catalog and how a connection becomes tools an agent can use.
Connecting a system usually needs credentials your platform or security team holds. Worth
requesting before you start, not mid-tutorial.
The SDK — only if you are authoring agents
Two paths through Build, and only one of them needs local tooling:- Deploying a Komodor-built agent — nothing to install. Everything happens in the console. See Use specialized agents.
- Authoring your own agent — you write a worker in Python or Go and run it against the control plane. See Build from scratch.
Programmatic access — only if you are automating
Driving KAOP from CI, a script, or your own service needs a credential:- An API key for a person-scoped or automation-scoped token — see API keys.
- A service account when the automation should have its own identity rather than borrowing yours — see Service accounts.
Quick check
You are ready when all of these are true:- You can sign in and land on your workspace
- You know which role you hold
- At least one system is connected
- The SDK is installed, if you plan to author agents
- You hold an API key, if you plan to automate
Next steps
Concepts & glossary
The vocabulary everything else assumes.
Build your first agent
Create and run one, end to end.
Onboarding
The guided checklist that tracks your setup.
Interfaces
Console, API, SDKs, MCP, Slack — and when to use each.