App Logo
dust.tt

List Dust agents

Automatically list Dust agents on dust.tt. List the agents available in the signed-in Dust workspace. Returns workspaceId and agents (sId, name, description, scope, status, model provider/id, userFavorite, canEdit, tags). sId is what you pass as `agent` to ask or send_message. Scope tells you where an agent comes from: "global" is a Dust built-in such as dust, helper, deep-dive or analyst, "workspace"/"published" is one your workspace created, "hidden"/"private" is personal. Requires being signed in to dust.tt.

Input

workspaceId optional

Workspace sId. Omit to use the first workspace on the account.

Output

agents required
workspaceId required

FAQ

List the agents available in the signed-in Dust workspace. Returns workspaceId and agents (sId, name, description, scope, status, model provider/id, userFavorite, canEdit, tags). sId is what you pass as `agent` to ask or send_message. Scope tells you where an agent comes from: "global" is a Dust built-in such as dust, helper, deep-dive or analyst, "workspace"/"published" is one your workspace created, "hidden"/"private" is personal. Requires being signed in to dust.tt.
Ask an AI agent connected to Reduck to run reduck/dust.tt/list_agents, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/dust.tt/list_agents
You do not need one. "List Dust agents" drives the real dust.tt pages in a browser, so it works whether or not dust.tt offers an API for this.
Optional: workspaceId.
It returns agents, workspaceId.
Yes. It acts as you on dust.tt: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the dust.tt cookies saved by the Reduck extension.
It only reads. It looks things up on dust.tt and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/dust.tt/list_agents, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/dust.tt/list_agents
It is part of Reduck's official curated catalogue.

Related scripts

dust.tt

Dust login (Google SSO)

Log into Dust with Continue with Google, handling the Google account chooser and consent screen, and land in your Dust workspace. Returns straight away if you are already signed in, and reports the Dust account and workspace. Optionally pass which Google account to use. Needs a browser that is already signed in to Google.

dust.tt

Dust whoami (signed-in account)

Report which Dust account this browser is signed in as: the user id, email and name. Being signed out is reported as a normal answer (loggedIn false), not an error, so it can be used to check a session before running other Dust scripts.

dust.tt

List Dust conversations

List the signed-in Dust workspace's conversations, newest first. Returns workspaceId and conversations (sId, title, created, updated, unread, hasError, actionRequired, isRunningAgentLoop, spaceId), plus hasMore and nextCursor for paging. sId is the join key for get_conversation_messages. Pass workspaceId to target a specific workspace when the account belongs to several; it defaults to the first workspace on the account. Paginate with cursor (pass back the nextCursor you were given) rather than an offset — the list is ordered by last update, so an offset would skip or repeat rows as conversations move. Requires being signed in to dust.tt.

Start building not clicking

Get started for free