setupaiagents.com
Guide · Updated April 22, 2026

OpenAI Workspace Agents Setup Guide (2026)

OpenAI launched Workspace Agents on April 22, 2026 — team-scope autonomous agents powered by Codex, free until May 6, then credit-based. This guide walks through setup the way an experienced operator would do it, not the marketing demo.

What are Workspace Agents?

Workspace Agents are team-scoped autonomous agents inside ChatGPT. They differ from Custom GPTs in three ways that matter for setup. First, they're multi-step: they chain tool calls, make decisions, and run for minutes or hours rather than responding to a single prompt. Second, they're team-scoped: one agent lives in a workspace and serves every authorized member, rather than being an individual's custom assistant. Third, they have persistent memory and can run continuously in the cloud — including when the user who invoked them is offline.

The practical consequence: agents are operator-grade automation, not chat enhancements. Setup is less "pick a template" and more "define a workflow, scope permissions, assign an owner."

Prerequisites

RequirementDetail
Plan tierChatGPT Business, Enterprise, Edu, or Teachers. Plus and Free do not include Workspace Agents.
Admin accessA workspace admin must enable the Agents feature and approve connectors. Builders can then create agents within admin-approved scopes.
Data source accessOAuth credentials for every system the agent touches (Drive, HubSpot, Slack, etc.). Least-privilege recommended.
A defined workflowOne workflow with a clear trigger, steps, and output. Vague use cases produce vague agents.
A named ownerOne person on the team who is accountable for the agent's behavior, tuning, and retirement.

Step-by-step setup

  1. 01

    Confirm your plan tier and admin access

    Workspace Agents are available on ChatGPT Business, Enterprise, Edu, and Teachers — not on Plus or Free. You need to be a workspace admin (or work with one) to enable agents and configure connectors. Check by going to ChatGPT → Settings → Workspace → Agents. If the menu isn't there, you're not on an eligible plan.

  2. 02

    Define the specific workflow you want to automate

    Skip this and your agent will be a generic chatbot. Write down the trigger (what event starts the agent), the steps (what the agent reads and does), and the output (where the result lands). A good first agent has exactly one trigger, fewer than five steps, and an output a human reviews before anything external happens.

  3. 03

    Map the connectors and permissions you'll need

    Workspace Agents use connectors to read and act on your data. List every system the agent touches: CRM, email, Slack, Drive, warehouse, ticketing. For each, decide the minimum permission scope — read-only if possible. Admins approve connectors per user group; scope them narrowly from day one.

  4. 04

    Build in the ChatGPT workspace under an admin-approved scope

    Create the agent from Settings → Agents → Create. You can describe the workflow in plain English, upload example inputs, or start from a template (finance, sales, marketing). The agent-authoring flow structures the steps, connects the tools you approved, and adds skills. Save as a draft and share with a small test group before workspace-wide rollout.

  5. 05

    Tune prompts against real data, not happy-path samples

    Most agent failures come from prompts that work on a demo and fall apart on real volume. Run the agent against 30–50 real inputs from the past two weeks. Read every output. Adjust the system prompt for the cases that look wrong. Repeat until the failure rate is below your team's tolerance — typically under 5% for first-touch use cases.

  6. 06

    Set up monitoring and a review loop

    Workspace Agents run continuously. That's their value and their risk. Set up a weekly review: sample 20 recent agent runs, grade them (right/wrong/needs-tune), and feed the wrong-and-needs-tune cases back into prompt revisions. Most teams do this for the first 4 weeks and then monthly thereafter.

  7. 07

    Hand off to an owner on your team

    An agent without a named owner becomes an orphaned asset. Assign one person on the team whose job includes monitoring the agent — not a group, not IT. Give them the system prompt, the connector list, the review checklist, and a rollback procedure. When the product changes or a connector breaks, they know what to do.

Native connectors at launch

OpenAI shipped Workspace Agents with native connectors for most business systems an SMB would use. Anything not on this list is typically accessible via the Actions framework or a Zapier bridge.

Google Workspace
Drive, Gmail, Calendar, Sheets, Docs
Microsoft 365
OneDrive, Outlook, Teams
Team messaging
Slack
CRM
HubSpot, Salesforce
Dev tools
GitHub, Linear
Docs & notes
Notion
Data warehouses
BigQuery (preview), Snowflake (preview)
Custom / everything else
Actions framework → any REST API

Admin controls every setup needs

  • Enable Workspace Agents at the org level — off by default in many Enterprise workspaces.
  • Approve connectors individually, not globally. Each connector gets scoped to specific user groups.
  • Set audit log retention to ≥ 90 days for any agent that writes to external systems.
  • Define a 'who can build agents' group. Don't leave it open to every seat.
  • Turn on SSO-enforced authentication for agent builders and owners.
  • Define an offboarding flow: when an agent owner leaves, the agent is paused until reassigned.

What happens on May 6, 2026

The research-preview period is free. After May 6, 2026, Workspace Agents run on credit-based pricing at the workspace level. Credits are consumed per agent invocation based on the model, tools used, and runtime length. A typical single-run agent (research + draft + post to Slack) is a fraction of a credit. Agents that run every hour across 50 users are considerably more.

During setup, estimate usage by: (invocations per day) × (average runtime seconds) × (tool calls per run). Size agents to have predictable cost — a Weekly Metrics Reporter running once is cheap; a Lead Outreach Agent running on every inbound can spike. Set per-agent credit caps to avoid surprises.

Common setup mistakes

Building before defining the workflow

Most agents that fail were started before anyone wrote down the exact trigger, steps, and output. Spend 30 minutes on the spec. It's the cheapest time you'll spend on this project.

Skipping the tuning phase

The agent-authoring flow feels finished after one test run. It isn't. Run against 30–50 real inputs before deciding the agent works. The failure cases you find at 50 samples would have taken weeks to surface in production.

Over-scoping connector permissions

It's tempting to grant the agent full Drive access because it's faster than scoping to one folder. Don't. Workspace Agents run continuously; a mis-prompted agent with org-wide write access is a bad day. Scope narrowly and widen only when you need to.

No owner assigned

An agent without a named human owner becomes orphaned within a quarter. When a connector breaks or the product changes, nobody notices until the output is already wrong. Assign ownership before launch, not after.

Questions

Want this built without spending your team's time on the learning curve?

20-min intro call. I've shipped agents for teams on both Business and Enterprise. I'll tell you what's realistic for your stack.

Related

About this guide. Written by Ilia Cherepanov, a solo consultant who builds Workspace Agents for US SMBs. This page is informational, not affiliated with OpenAI. "ChatGPT," "OpenAI," and "Codex" are trademarks of OpenAI, OpCo, LLC.