---
title: "Overview"
canonical: https://workspace.socra.com/docs/agents
---

# 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](https://admin.socra.com/directory/agents). 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](/docs/agents/get-started) to create an agent and delegate a first task. For an ongoing responsibility, read [Delegate work](/docs/agents/guides/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](/docs/agents/concepts/context-and-memory) and [Events and execution](/docs/agents/concepts/events-and-execution) before relying on an agent for ongoing work.

## Manage and integrate

Use [Guides](/docs/agents/guides/connect-ai-provider) for setup and management, [Reference](/docs/agents/reference/cli) for commands and API operations, and [Troubleshooting](/docs/agents/troubleshooting) when work stalls.