Workspace Admin Quickstart
===========================

This guide walks you through setting up your workspace so your team can log in and start building agents. By the end, your members will have the right roles and the credentials they need to get started.

**Time to complete:** ~10 minutes.

.. image:: /images/gs-workspace-home.png
   :alt: Command Center home after accessing a workspace
   :align: center
   :width: 100%

|

Step 1 — Access Your Workspace
--------------------------------

Log in to OneByZero Neo with your credentials. If you have access to more than one workspace, the workspace switcher in the top-left corner lets you move between them.

After login you land on the **Command Center Home** — the agent listing for your workspace. It will be empty until agents are created.

Step 2 — Create Roles
-----------------------

Before inviting members, define the roles that reflect your team's responsibilities. Each role is a named collection of permissions.

1. Open **Workspace Settings** (gear icon, bottom-left).
2. Navigate to the **Roles** tab.
3. Click **+ Create Role**.
4. Name the role (e.g. ``Agent Builder``, ``Viewer``) and toggle the permissions appropriate for that role.
5. Save.

At minimum, create one role for builders (who create and edit agents) and one for viewers (who can only interact with published agents). For details, see :doc:`/7_workspace_admin/roles_permissions`.

Step 3 — Invite Members
-------------------------

1. In **Workspace Settings**, navigate to the **Members** tab.
2. Click **+ Invite Member**.
3. Enter the user's email address.
4. Assign them one of the roles you just created.
5. Save. The user receives an invitation and can now log in.

For details, see :doc:`/7_workspace_admin/member_management`.

Step 4 — Add Secrets and Variables
------------------------------------

Agents often need credentials and configuration values at runtime — API keys, database connection strings, environment-specific settings. Store these centrally so agents can reference them without embedding them in the flow.

1. In **Workspace Settings**, navigate to the **Secrets** tab for sensitive values (API keys, tokens, passwords).
2. Click **+ Add Secret**, enter the key name and value, and save.
3. Navigate to the **Variables** tab for non-sensitive configuration values.
4. Click **+ Add Variable**, enter the key and value, and save.

For details, see :doc:`/7_workspace_admin/variables_secrets`.

Your workspace is ready. Point your builders at the :doc:`Build Your First Agent <for_users>` guide.