Publish to a channel
By the end of this page you will know how to publish your Task Agent to a deployment so it can be accessed via a Chat Widget, API, or other channel.
Prerequisites
- A Task Agent in PRODUCTION status (Versioning & promotion).
- Admin or Developer role.
- At least one deployment in the project (Deploy).
Understanding publishing
Publishing connects your agent to a deployment. A deployment is a running environment with a URL (e.g., your-app.dev.qraptor.app) that exposes one or more channels:
| Channel | Description |
|---|---|
| Chat Widget | Embeddable web chat UI |
| Application Service | REST API endpoint for programmatic access |
| Copilot | AI assistant interface |
| Agents | Agent-to-agent communication (A2A protocol) |
When you publish an agent to a deployment, it becomes available through all channels configured on that deployment.
Publishing your agent
Open the Deploy menu
In the Agent Builder toolbar, click the Deploy button. A dropdown menu appears showing:
- New Deployment — Create a new deployment for this agent.
- Add to: section — Lists existing deployments you can add the agent to.
Select an existing deployment
Click an existing deployment (e.g., “resolution-agent (copilot)”) to add your agent to it. The agent is immediately available at that deployment’s URL.
Alternatively, click New Deployment to create a fresh deployment — this opens the deployment creation wizard (see Deploy for details).
Verify the publication
Navigate to Deployments in the project sidebar. Click your deployment to confirm the agent appears in its agent list.
You can publish the same agent to multiple deployments — e.g., one for internal testing and another for customer-facing production.
Channel-specific configuration
Once your agent is published to a deployment, configure channels from the deployment settings:
- Chat Widget — Customize appearance (colors, position), welcome message, and allowed domains for embedding.
- API — Generate API keys for programmatic access. Configure rate limits and authentication.
- Copilot — Set the copilot context and behavior rules.
Channel configuration is managed at the deployment level, not per agent. All agents in a deployment share the same channel settings.
Removing an agent from a deployment
To unpublish an agent, navigate to the deployment settings and remove the agent from the agent list. The agent remains in your project but is no longer accessible via that deployment’s channels.
Common issues
- No deployments available — Create a deployment first from the project’s Deployments page or via the “New Deployment” option.
- Agent not responding after publish — Verify the agent is in PRODUCTION status. DRAFT agents cannot serve traffic.
- “Deployment limit reached” — Your plan limits the number of active deployments. Upgrade or remove unused deployments.