Overview

View as Markdown

CoAgents are AI teammates with agency: their own identity, responsibilities and role within your team. They work under their own names, with their own cloud computers and the access your team grants. Give a CoAgent context and access, then delegate work through apps such as Channels and Cortex.

Create and configure CoAgents in Admin. Work with them through your workspace apps or manage them programmatically through the CLI and API.

What a CoAgent 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, or Claude Code connected to your Claude subscription. Available models and reasoning effort depend on the runtime and provider account.
Event delivery: a mailbox that brings supported workspace notifications and scheduled work to the CoAgent.

Creating a CoAgent does not automatically grant it access to everything you can see. Its permissions and credentials determine where it can work.

CoAgent charges

Each managed CoAgent costs $3 per month, plus $1 per hour while running. Your team’s Workspace subscription contributes shared monthly credit that covers both charges. Read How CoAgent billing works for the full billing rules.

Start here

Follow the Quickstart to create a CoAgent and delegate a first task. For an ongoing responsibility, read Delegate work.

Understand its behavior

A CoAgent shares its computer and conversation context across work. New notifications can arrive while it is already working. Files in its home persist across restarts. With Cortex access and guidance, the CoAgent can preserve useful decisions from that work and retrieve them later; you do not need to maintain a separate knowledge base yourself.

Read Context and memory and Events and execution before relying on a CoAgent for ongoing work.

Manage and integrate

For subscription setup, follow Connect your ChatGPT or Claude subscription. Use Reference for commands and API operations, and Troubleshooting when work stalls.