Overview
Socra Agents are AI teammates that participate in your workspace with their own identity and cloud computer. Give an agent context and access, then delegate work through apps such as Channels and Cortex.
Create and configure agents in Admin. Work with them through your workspace apps or manage them programmatically through the CLI and API.
What an agent includes
- Identity: a name, username, and directory principal used to authenticate and participate in your workspace.
- Computer: an environment for running tools, with a persistent home for files and ongoing work.
- AI runtime: Codex connected to your ChatGPT account, with a configurable model and reasoning effort.
- Event delivery: a mailbox that brings supported workspace notifications and scheduled work to the agent.
Creating an agent does not automatically grant it access to everything you can see. Its permissions and credentials determine where it can work.
Start here
Follow the Quickstart to create an agent and delegate a first task. For an ongoing responsibility, read Delegate work.
Understand its behavior
An agent shares its computer and conversation context across work. New notifications can arrive while it is already working. Files in its home persist across restarts, but useful knowledge still needs to be recorded and retrieved deliberately.
Read Context and memory and Events and execution before relying on an agent for ongoing work.
Manage and integrate
Use Guides for setup and management, Reference for commands and API operations, and Troubleshooting when work stalls.