Overview
The AI Agents page is the central control plane for every AI Agent in your workspace. As your agent library grows, this hub gives you full visibility into what's deployed, what's running, and who last changed it, without digging through individual workflows. From here, you can publish agents to make them available across the platform, monitor their lifecycle state, review version history, and manage changes. Before deleting an agent, Torq performs a dependency check and surfaces all workflows, sessions, or cases that currently invoke it, preventing accidental breakage.
Agent lifecycle
Agents follow a lifecycle that separates development from production, ensuring stable behavior for all workflows and platform components that depend on them.
Draft
A newly created agent starts in Draft state. In this state, you can freely edit the agent's instructions, tools, output schema, and model configuration. Draft agents are not visible to other platform components and cannot be invoked externally, changes you make won't affect production until you publish.
Published
Publishing an agent promotes the current draft to production. Once published, the agent becomes available across the Torq platform, including workflows, Socrates, other AI Agents, and case management. Other components always interact with the published version, ensuring stability and predictability.
Unpublished changes
If you continue editing an agent after publishing, it enters the Unpublished changes state. This means a stable production version is running while a newer draft is in development. The production version continues to operate without disruption until you publish again.
How to use
Migrate agents to the AI Agent hub
Agents built inside workflows are moving to the AI Agent hub, where they live in one shared place and can be reused across the workspace. Agents flagged for migration must be published to the hub to keep workflows running.
Once migrated, the agent lives in the hub as a shared resource and can be reused across any workflow in the workspace.
For details, see AI Agents: Migrate Workflow Agents to the AI Agent Hub.
View and search agents
The hub lists all agents in your workspace with the following information:
Name: The agent's name.
Tools: Tools assigned to the agent's toolbox.
Status: The agent's current lifecycle state.
AI model: The model configured for the agent.
Created: Who created the agent and when.
Modified: Who last modified the agent and when.
Use the search bar to find agents by name, or filter by Tool type, Tool vendor, Status, Created by, or Modified by. The list updates in real time to show only agents matching your search term or active filters.
Switch between list and grid view
The hub supports two display modes. Click the view toggle in the top-right corner to switch between them.
List view: Displays agents in a table with columns for name, tools, status, AI model, created, and modified. Use this view to compare agents across multiple attributes at a glance.
Grid view: Displays agents as cards showing the agent name, status, model, description, and tool icons. Use this view to browse agents by identity and purpose.
Create an agent
Agents can be created from the workflow canvas or directly from the AI Agents page. We recommend using Build with Socrates: it guides you through the agent's role, instructions, tools, and output automatically, and publishes the agent when complete. For a full walkthrough, see Build an AI Agent with Socrates.
Build with Socrates (recommended)
Socrates opens in Builder mode and works through the agent's configuration by asking questions. A configuration artifact updates alongside the chat as the agent takes shape.
From the AI Agents page
Open the hub: Go to Build > AI Agents.
Start the Builder: Open an existing Draft agent, or click Create. Then click Build with Socrates in the top bar.
Answer Socrates' questions: Socrates guides you through the agent's role, instructions, parameters, tools, and output. For guidance on structuring your input, see Socrates Builder: Prompting and Iteration Guide.
Review the configuration artifact: Use the Properties, Instructions, Params, Tools, and Output tabs to review and refine what Socrates has built.
Finish and choose how to proceed: When the agent is complete, two options appear:
Back to Canvas: Returns to the workflow. The placeholder step is replaced with the live agent.
Open Agent Hub: Opens the agent in the hub for further review or manual adjustments.
From the canvas
Place an agent step: In the step picker, select AI Agents, then drag New AI Agent onto the canvas.
Start the Builder: Click the New AI Agent placeholder step to select it, then click Build with Socrates above it. Socrates opens in Builder mode. Use the breadcrumb at the top to return to the canvas at any point.
Answer Socrates' questions: Socrates guides you through the agent's role, instructions, parameters, tools, and output. For guidance on structuring your input, see Socrates Builder: Prompting and Iteration Guide.
Review the configuration artifact: Use the Properties, Instructions, Params, Tools, and Output tabs to review and refine what Socrates has built.
Finish and choose how to proceed: When the agent is complete, two options appear:
Back to canvas: Returns to the workflow. The placeholder step is replaced with the live agent.
Open AI Agents page: Opens the agent in the hub for further review or manual adjustments.
Create manually in the AI Agents page
Opening the hub editor lets you define the agent's instructions, tools, model, and parameters yourself before publishing. For a full walkthrough, see AI Agent Setup.
From the canvas
Place an agent step: In the step picker, select AI Agents, then drag New AI Agent onto the canvas.
Open the hub editor: Click the New AI Agent placeholder step to select it, then click Create in AI Agents above it. A new agent opens in Draft state.
Configure the agent: Define the agent's instructions, tools, model, and parameters. For a full walkthrough, see AI Agent Setup.
Publish: Click Publish to make the agent available. The placeholder step on the canvas is replaced with the live agent.
Return to the canvas: Click the workflow name in the breadcrumb at the top of the editor to go back.
From the AI Agents page
Open the hub: Go to Build > AI Agents.
Create: Click Create in the top-right corner. A new agent opens in Draft state.
Configure the agent: Define the agent's instructions, tools, model, and parameters. For a full walkthrough, see AI Agent Setup.
Publish: Click Publish to make the agent available across Torq.
Agent operations
The following operations are available from the hub and the agent's three-dot menu.
Publish an agent
Publishing makes your agent available across the platform. Until published, an agent cannot be invoked by workflows or other components.
Open the agent menu: Click the three-dot (…) menu next to the agent.
Publish: Click Save and Publish.
Once published, the agent appears in the Published Agents panel in the workflow builder, under the AI Agents step category. From there, it can be added directly to a workflow.
Duplicate an agent
Duplicating creates an independent copy of the agent in Draft state, useful for building variations without modifying the original.
Open the agent menu: Click the three-dot menu next to the agent.
Duplicate: Select Duplicate.
A copy of the agent appears in the hub in Draft state. The duplicate is fully independent; changes to it do not affect the original.
Unpublish an agent
Unpublishing removes the agent from production and returns it to Draft state. Any workflows or platform components that invoke it will stop working until the agent is republished.
Before unpublishing, check whether any workflows or components depend on this agent to avoid breaking live automations.
Open the agent menu: Click the three-dot menu (…) next to the agent.
Unpublish: Select Unpublish and confirm.
The agent returns to Draft state and is no longer invokable by workflows or platform components until it is republished.
Edit an agent
Editing an agent creates a new draft while keeping the published version live.
Open the agent: Click the agent name in the hub.
Make changes: Edit the agent's instructions, tools, output schema, or model configuration.
Save: Click Save. The agent enters Unpublished changes state until you publish.
The published version continues running without interruption. Your changes take effect for all callers only after you publish the updated draft.
Disable an agent
Disabling temporarily stops an agent from executing without removing its configuration or breaking dependent components. Use this when you need to investigate unexpected behavior, perform maintenance, or suspend executions safely.
Open the agent menu: Click the three-dot (…) menu next to the agent.
Disable: Select Disable.
The agent stops executing immediately. Dependent workflows and components remain intact and resume automatically when the agent is re-enabled.
Delete an agent
Deleting an agent is permanent. Before proceeding, Torq checks all dependencies and surfaces any workflows, sessions, or cases that currently invoke it.
Open the agent menu: Click the three-dot menu next to the agent.
Delete: Select Delete. If dependencies are found, review and resolve them before confirming deletion.
The agent is permanently removed from the hub and can no longer be invoked by any workflow or platform component.
Agent templates
Agent templates are Torq-provided, pre-configured agents built for common security automation use cases. Each template includes a predefined role, instructions, tools, and output schema, ready to customize and publish.
Use a template
Open the template gallery: On the AI Agents page, click Templates.
Browse or search: Scroll through the gallery or use the search bar to find a template by name or use case.
Select a template: Click a template card to preview its description and tools. To share the template with someone, click Copy Link.
Use the template: Click Use to create a new Draft agent pre-configured with the template's settings.
Customize and publish: Edit the agent's instructions, tools, or parameters as needed, then click Save and Publish to make it available across Torq.
Templates create an independent Draft agent; changes to the original template do not affect agents already created from it.