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

Get Dust conversation messages

Read a Dust conversation's messages by conversation sId (from list_conversations or search_conversations), oldest first. Returns workspaceId, conversationId, title, a truncated flag, and messages: each with sId, role (user or agent), content, created, rank, plus author (the human's name/email on a user turn) and agent (the mentioned agent's id on an agent turn). truncated is true when limit stopped it before the first message, so the oldest turns are missing. An unknown conversation id fails loudly rather than returning an empty transcript. Requires being signed in to dust.tt.

dust.tt

Search Dust conversations

Search the signed-in Dust workspace's conversations by title text. Returns workspaceId and the matching conversations (sId, title, created, updated, spaceName), newest-updated first, with hasMore and nextCursor. sId is the join key for get_messages. The search covers conversation titles, not message bodies, so a word spoken inside a chat will not match unless it is also in the title — and Dust titles conversations automatically, so titles are paraphrases of the opening message. An empty match list is a real answer about the query, not a failure. Requires being signed in to dust.tt.

Start building not clicking

Get started for free