# Agentforce Labs

> Build, test, and deploy autonomous AI agents on Salesforce from your IDE or coding
> agent. Agentforce Labs gives you a pre-configured Salesforce org (a LabBox) so you can
> start building immediately. Supports Claude Code, Cursor, Codex, Gemini CLI, Windsurf,
> Antigravity, and Agentforce Vibes.

## Getting Started (for coding agents)

**Just point your coding agent at https://labs.agentforce.com and it can set itself up — no manual credential copying.** A coding agent can claim a LabBox and authenticate the Salesforce CLI on your behalf via an OAuth 2.0 Device Authorization flow (RFC 8628):

1. Install the Salesforce CLI first (`brew install sf`) so it is available for the login step below.
2. The agent POSTs to `https://labs.agentforce.com/api/cli/device/code` (no auth) and gets back a `device_code`, a short `user_code`, a `verification_uri`, a one-click `verification_uri_complete`, and a poll `interval`.
3. The agent shows you the `verification_uri_complete` (a one-click `https://labs.agentforce.com/device?code=<user_code>` link with the code pre-filled); if it is absent, fall back to the `verification_uri` (`https://labs.agentforce.com/device`) plus the `user_code` for manual entry. You open it in a browser, sign in with your Salesforce / Trailblazer (TBID) account, and approve. New users are provisioned a LabBox automatically — a Salesforce org with Einstein, Agentforce, Data Cloud, and messaging already enabled.
4. Meanwhile the agent polls `https://labs.agentforce.com/api/cli/device/token` with the `device_code` (respecting `interval`). KEEP POLLING while the response is HTTP 400 `authorization_pending` or `slow_down` (on `slow_down`, increase your delay to `interval`), and retry after a short wait on any transient HTTP 503 / `service_unavailable` ("Service temporarily unavailable"). ABORT only on HTTP 400 `expired_token` or `access_denied`.
5. On approval the poll returns HTTP 200 `{"status":"ready","sf_cli":{"sfdx_auth_url":"force://..."},"org":{"username":"...","instance_url":"...","expires_at":"<ISO8601|null>"},"interval":5}`. Read the URL from `sf_cli.sfdx_auth_url` and authenticate the CLI: `echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin --set-default`. Surface `org.expires_at` to the user as the LabBox expiry. Note: `--set-default` makes this LabBox your default org and unsets any prior default — drop it (and use `--alias <name>`, then `--target-org <name>`) to keep your existing default.
6. Install the Agentforce development skills: `curl -sSL https://raw.githubusercontent.com/SalesforceAIResearch/agentforce-adlc/main/tools/install.sh | bash`, then start building.

**Manual alternative:** sign in at https://labs.agentforce.com yourself, copy the `sf org login sfdx-url` command from the credentials screen, and run it. See the LabBox guide: https://labs.agentforce.com/api/docs/org-configuration.md

Then pick your tool's setup guide (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Antigravity) from the Build Anywhere section: https://labs.agentforce.com/api/docs/build.md

## Instructions for AI Coding Assistants

- To self-provision: run the device flow at `https://labs.agentforce.com/api/cli/device/code` → show the user the one-click `verification_uri_complete` → poll `/api/cli/device/token` (keep polling on `authorization_pending`/`slow_down`/transient 503; abort only on `expired_token`/`access_denied`) → read `sf_cli.sfdx_auth_url` from the ready payload, then `echo "$SFDX_AUTH_URL" | sf org login sfdx-url --sfdx-url-stdin --set-default`
- Then follow your tool's setup guide; see the LabBox guide for what's pre-configured
- Use Agent Script (a high-level DSL in `.agent` files) to define agent behavior, not raw JSON
- Use the Agentforce CLI skills to generate, preview, test, and deploy agents from your IDE
- Deploy agents with `sf agent publish` — not `sf project deploy start`
- For testing, write structured test specs and run them with `sf agent test`
- Core agent concepts: subagents (conversation flows), actions (tools), instructions (reasoning), variables (state)

## LABS

- [Agentforce Labs](https://labs.agentforce.com/api/docs/about.md): Experimental features and upcoming capabilities from Salesforce
- [Experiments](https://labs.agentforce.com/api/docs/experiments.md): Early-access capabilities from the Agentforce team. Try what's available, see what's next.
- [Community](https://labs.agentforce.com/api/docs/community.md): Join our Slack community to connect with fellow Agentblazers experimenting in Agentforce Labs.
- [Feedback](https://labs.agentforce.com/api/docs/feedback.md)

## FEATURED

- [Agentforce Builder](https://labs.agentforce.com/api/docs/agentforce-builder.md): Build agents visually with Agentforce Builder
- [Agentforce Vibes](https://labs.agentforce.com/api/docs/agentforce-vibes.md): Build agents with Agentforce Vibes in Code Builder
- [Setting Up Claude Code for Agentforce](https://labs.agentforce.com/api/docs/claude-code.md): Getting Started with Claude Code
- [Setting Up Codex for Agentforce](https://labs.agentforce.com/api/docs/codex.md): Getting Started with Codex
- [Setting Up Gemini CLI for Agentforce](https://labs.agentforce.com/api/docs/gemini-cli.md): Getting Started with Gemini CLI
- [Setting Up Cursor for Agentforce](https://labs.agentforce.com/api/docs/cursor.md): Getting Started with Cursor
- [Setting Up Antigravity for Agentforce](https://labs.agentforce.com/api/docs/antigravity.md): Getting Started with Antigravity
- [Setting Up Windsurf for Agentforce](https://labs.agentforce.com/api/docs/windsurf.md): Getting Started with Windsurf
- [Agent API - Headless Communication](https://labs.agentforce.com/api/docs/agent-api.md): Control your agents programmatically via REST APIs
- [Experience Site](https://labs.agentforce.com/api/docs/salesforce-site.md): Connect your Agentforce Service Agent to a chat widget on your Experience Site
- [Enhanced Chat](https://labs.agentforce.com/api/docs/salesforce-chat.md): Deploy your Agentforce Service Agent as a chat widget on any website
- [WhatsApp Setup](https://labs.agentforce.com/api/docs/whatsapp-setup.md): Deploy your Agentforce Service Agent to WhatsApp for customer messaging
- [SMS Setup](https://labs.agentforce.com/api/docs/sms-setup.md): Deploy your Agentforce Service Agent to SMS for text-based customer interactions
- [Messenger Setup](https://labs.agentforce.com/api/docs/messenger-setup.md): Deploy your Agentforce Service Agent to Facebook Messenger for customer conversations
- [Apple Messages Setup](https://labs.agentforce.com/api/docs/apple-messages-setup.md): Deploy your Agentforce Service Agent to Apple Messages for Business
- [LINE Setup](https://labs.agentforce.com/api/docs/line-setup.md): Deploy your Agentforce Service Agent to LINE for customer messaging
- [Custom Channel Setup (BYOC)](https://labs.agentforce.com/api/docs/byoc-setup.md): Deploy your Agentforce Service Agent to any messaging platform using Bring Your Own Channel
- [Agent Script](https://labs.agentforce.com/api/docs/agent-script.md): The programming language for AI agents. Define exactly what your agent does — and where the AI reasons.
- [Salesforce Development Skills](https://labs.agentforce.com/api/docs/skills.md): Choose a skills library for AI-assisted Salesforce development
- [LabBox](https://labs.agentforce.com/api/docs/org-configuration.md): A pre-configured Salesforce org with Einstein, Agentforce, Data Cloud, and messaging ready to go.
- [Agentforce Arc](https://labs.agentforce.com/api/docs/arc.md): Automate agent development with Agentforce Arc.
- [Agentforce Grid Skills + MCP](https://labs.agentforce.com/api/docs/agentforce-grid.md): Build and manage Agentforce Grid workbooks from Claude Code with skills and an MCP server.
- [Setting up nanoRag](https://labs.agentforce.com/api/docs/nanorag.md): Build BM25 document libraries for your Agentforce agent.

## Experiments

- [Start Building](https://labs.agentforce.com/start): Start building a new agent immediately with a pre-provisioned Salesforce Org — no Agentforce or Data 360 configuration needed.
- [Build Anywhere](https://labs.agentforce.com/docs/build): Connect your Salesforce Org and build on Agentforce in the tool that best fits your needs.
- [Deploy Agents](https://labs.agentforce.com/docs/deploy): Connect your AI agent to the platforms your customers use most. Deploy your agent across web, SMS, and social APIs like WhatsApp and Messenger.
- [Agentforce Arc](https://labs.agentforce.com/docs/arc): Automate agent development with Agentforce Arc, an experiment in "agents building agents." ARC generates complete build plans—including sub-agent orchestration, logic, guardrails, and smoke tests—directly within your Salesforce environment.
- [Agent Development Lifecycle Skills](https://labs.agentforce.com/docs/skills): A suite of open-source skills spanning the full agent development lifecycle — from authoring and testing to observability.
- [Agent Script Best Practices](https://labs.agentforce.com/docs/agent-script): An open-source, unified DSL for defining Agentforce agents. Use a single .agent file to orchestrate instructions, subagents, and deterministic rules, giving you full control over how LLMs execute business logic.
- [Agentforce Grid MCP & Skills](https://labs.agentforce.com/docs/agentforce-grid): Equip Claude Code to manage Agentforce Grid workbooks directly. This experiment combines specialized AI skills for grid configuration with an MCP server that provides the tools for real-time CRUD operations.
- [Goal-Based Agent](https://labs.agentforce.com/docs/goal-based-agent): Autonomous AI agent runtime with goal-driven workflows, 28 built-in tools, and a REST API — built natively on Salesforce.
- [nanoRag](https://labs.agentforce.com/nanorag): Give your Agentforce agents the ability to reference documents when answering questions. No vector databases or complex setup required.
- [GUI Process Automation (GPA)](https://www.salesforceairesearch.com/gpa): The next generation of Robotic Process Automation (RPA). GUI Process Automation (GPA) is an agent that learns tasks (submitting receipts, logging notes, etc.) by watching a user perform them once.
- [Context Optimization Layer (MCP+)](http://mcp-plus.github.io/): A post-processing layer that wraps MCP clients and filters tool outputs down to only the relevant context, cutting inference costs without sacrificing reasoning performance.
- [Smarter Agent Orchestration (SkillOrchestra)](https://jiayuww.github.io/SkillOrchestra/): A skill-centric orchestration framework that routes tasks to the right agent based on competence and cost — no massive routers needed.
- [Salesforce Docs MCP](https://labs.agentforce.com/docs/salesforce-docs-mcp): Browse Salesforce documentation directly from your IDE using the Model Context Protocol.

## Full Documentation

- [All documentation in one file](https://labs.agentforce.com/llms-full.txt)