Skip to content

AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mission is to provide the tools, so that you can focus on what matters.

2.0 KB
Raw Blame

Conductor Manage Session

Renames, cancels or archives a Conductor agent session. Requires your own Conductor API key, created at app.conductor.build/users/api-keys and added through AutoGPT’s credentials UI. Select that credential for each Conductor block; no server-wide default key is used.

Conductor Manage Session

What it is

Rename, cancel or archive a Conductor agent session. Cancel stops the running turn and drops queued prompts.

How it works

One action per run: rename posts {name} to /rename; cancel posts {} to /cancel, stopping the current turn and dropping queued prompts; archive posts {} to /archive. Cancel and archive report canceled_queued_messages. The status output is Conductor's immediate response: cancellation can still report working while the agent stops. Use Get Session to confirm that it reaches idle.

Inputs

Input Description Type Required
session_id Session ID str Yes
action rename, cancel (stop the current turn and drop queued prompts) or archive "rename" | "cancel" | "archive" No
name New session name (rename) str No

Outputs

Output Description Type
error Error message if the operation failed str
session_id Session ID str
workspace_id Workspace the session belongs to, when reported str
status Session status after the action, when reported str
canceled_queued_messages Queued prompts dropped by cancel or archive int
result Raw API response Dict[str, Any]

Possible use case

Stop a runaway agent: Cancel a session whose status has been working past a deadline.

Housekeeping: Archive finished sessions so Get Workspace lists only active chats.