Duaer

AI, deploy, and more

Turn Agents on in Duaer

In Duaer, Settings > Agents turns Agents on for the instance and shows the sandbox shared with Duaer Designer.

Turn Agents on for the instance

  1. Open Settings > Agents.
  2. Turn on Enable Agents.

Turning it off blocks new runs and cancels pending messages. A run that has already started can finish. Saved agents and history stay, and they are available again when you turn Agents back on.

Shared sandbox

Agents and Duaer Designer use the same sandbox connection. A change on this page affects both.

When Duaer Designer is off, set the sandbox with environment variables, or turn Duaer Designer on and manage the sandbox here.

Limits on one agent

  1. Open Usage and limits on that agent.
  2. Set a monthly budget, an alert percent, and a cost cap per session.

The agent stops when it reaches the monthly budget or the session cap. The budget alert needs a monthly budget.

Offer the agent in Duaer Chat

After you make the agent available, everyone in that project can find it in Duaer Chat. The description is optional. Use it to say what the agent can help with.

What agents may read and do

An owner or admin of the organization opens Duaer Settings › AI rules and uses the Agents section. The settings apply to every agent in the organization; one agent can be held tighter, never looser.

  • Sources agents and assistants read: all sources by default. With Only the chosen sources, agents and employee portal assistants search and answer from those sources only; an assistant's own sources apply within them.
  • Leave out documents with high-risk sensitive content: agents cannot read documents in which the sensitive content scan found ID card, bank card or passport numbers, passwords, keys or other high-risk content. Only documents the scan checks count. By default it checks documents shared with the whole company or anyone; to cover documents only a few people read, set the scan to All documents.
  • Templates: Read only sends no messages, writes no data tables and runs no workflows. No outside contact sends nothing to outside channels and has no web access. Ask first asks before every action. Strict is Read only with no web access and no high-risk documents. A template fills the action rules above; nothing changes until you save.
  • One agent at a time: give an agent a template, or let it read only some sources. A template blocks a tool even where the organization allows that tool. An agent held to sources outside the organization list reads nothing.
  • Tools and MCP servers: choose Add tool or Add MCP server and pick from the tools and servers the organization’s agents use (web search and sending to connected channels included), each with the agents that use it, then Allow, Ask first or Block. A saved rule whose name no agent uses is marked and does not apply. A rule saved under a tool’s earlier name still applies, and the page says which tools it covers.

The sources and the high-risk switch cover agents and employee portal assistants, including assistants used in Feishu, WeCom, DingTalk and through MCP; templates and One agent at a time cover agents only. People searching in Ask Duaer, MCP clients and the API read with their own access. Every save is recorded in the audit log.

A plan in the chat

When an agent lists a plan in Duaer, the chat shows the title and how many tasks are done. A task can be pending, in progress, done, failed, or canceled.

When a plan change is rejected, that step says so. Expand it for the reason, or open the trace.

Receive messages on WhatsApp

  1. Create Meta app: in the Meta App Dashboard, create an app with the WhatsApp product. You need a business portfolio in Meta Business Suite and a phone number not already in use with WhatsApp.
  2. Create credential: a WhatsApp Business credential with the Phone number ID, WhatsApp Business Account ID, access token and App secret. Use a permanent system user token, not the temporary one from API Setup. Duaer checks the credential with Meta.
  3. Configure webhook: in your Meta app, open WhatsApp, then Configuration, and paste the callback URL and the verify token. Meta accepts HTTPS callback URLs only.
  4. Verify in Meta: choose Verify and save, then next to Webhook fields choose Manage and subscribe to messages. Duaer confirms this step once Meta reaches the agent.
  5. Connect: when the steps before are done, choose Connect.

The agent receives messages and replies inside Meta’s 24-hour customer service window. Configuration sets the typing indicator, whether the agent downloads the images, documents and audio customers send, and how many days that media is kept.

Receive messages on Microsoft Teams

Connect Teams in one of two ways. Recommended setup: sign in with the work account of the organization where people will use the agent, and Duaer creates the app and the bot. Use your own Microsoft app: connect an app registration and an Azure Bot you set up in Azure, with the Directory (tenant) ID, Application (client) ID and client secret.

If sign-in stops at Need admin approval, choose Copy link for an admin: an admin of your organization approves Duaer once.

Once an admin approves, the agent can find people by email and channels by name, read attached files, and send scheduled messages to people and channels. A different credential means a different bot: choose Set up again to remove the current Teams connection and start over. The agent does not answer in Teams until the new setup is finished.

Shared skills

With DUAER_AGENTS_SKILLS_HUB_ENABLED=true on every main and worker (read at start), skills live in Settings > Context > Skills and can be shared. A skill is Global (any agent can add it), for one project, or for one agent only.

In an agent, add a skill from the skill picker, or create one. An agent keeps the version it added; Use latest version moves it on. You can use a skill you may not edit, but not change it.

With it on, you can also ask Duaer Designer to list, create, update and delete skills, and so can an MCP client granted List and read skills or Create, update and delete skills.

Without that variable, skills stay on each agent as before.

Sync skills from GitHub

In Settings > Context > Skills, select Connect to GitHub, choose a GitHub credential that can read the repository, then the repository (it can be private). Duaer reads the default branch and finds every SKILL.md. A global source uses a credential that admins own; a project source lists only credentials that project owns or that are shared with it.

Before importing, Duaer checks every skill and leaves out the ones with problems. Later changes on GitHub arrive here as updates to review, and take effect once you accept them. Edit a synced skill in GitHub; to edit or move it on its own in Duaer, stop syncing it first.

Every skill has versions. Under its Versions you see which files each version changed, which agents use which version, and the version the published agent uses.

Agent versions and publishing

In an agent's version history, publish a saved version, with a name and a description if you like. The timeline records each publication and unpublication, and how long each version was live.

Stop a running session from the session log. Session logs can also be read over MCP: a client granted List and read agents can list an agent's sessions and read one of them.

Questions

Does a running agent stop when you turn Agents off in Duaer?

A run that has already started can finish. New runs are blocked and pending messages are canceled. Saved agents and history stay.

Do Agents and Duaer Designer share a sandbox?

Yes. The sandbox on Settings > Agents is the one Duaer Designer uses too.

How does an agent in Duaer receive WhatsApp messages?

Connect a WhatsApp Business credential, publish, then paste the callback URL and verify token into WhatsApp Configuration in Meta and subscribe to messages. Replies stay inside the 24-hour customer service window.

In this section

AI

Build your first AI Agent in Duaer

Connect a chat model to an AI Agent in Duaer, then add tools when you need them. This page is the smallest workflow that runs.

AI

Use Chat hub in Duaer

Chat hub gives people a chat entry without the canvas. From Duaer v3 it is off by default. You can turn it on temporarily with DUAER_ENABLED_MODULES.

AI

Retrieve relevant context with RAG in Duaer

Write documents into a vector store, then retrieve pieces for the model when someone asks. Duaer RAG usually has a load branch and a retrieve branch.

AI

Use $fromAI for tool parameters in Duaer

In Duaer: $fromAI marks a parameter the AI Agent fills when it calls a tool. Keys may only use letters, numbers, underscores, and hyphens.

AI

Understand why to evaluate in Duaer

In Duaer, use evaluations against known test cases so AI workflows stay reliable across inputs.

AI

Run light evaluations in Duaer

In Duaer, during development run a workflow against a few known cases and compare outputs side by side before you add formal metrics.

AI

Use metrics to measure quality in Duaer

In Duaer: Run an AI workflow against a test set and record scores you calculated, so you can compare versions over time.

AI

Fix common evaluation issues in Duaer

In Duaer, when triggers, field maps, or chat output fight the evaluation nodes, check the wiring first.

AI

Turn on the Duaer MCP server

In Duaer, expose the instance as an MCP server so outside clients operate workflows with permission. Turn access on in the instance first.

AI

Draft Duaer workflows with AI

In Duaer, describe your goal in plain language. The builder generates or edits digital-organization nodes. You still confirm on the canvas.

AI

Fix failing workflows with self-healing

When a published workflow fails in production, Duaer Designer investigates, tests a fix on a copy, and sends it to Reviews. The workflow does not change until a reviewer applies the fix.

AI

Connect an MCP client to Duaer

After MCP access is on in Duaer, put the connection URL and auth into the client config.

AI

Use Duaer Designer on cloud

Duaer Designer on cloud is toggled in Settings and helps edit workflows.

AI

Manage MCP access on Duaer cloud

After you turn on MCP access on a Duaer cloud instance, outside clients can connect.

Deploy

Set up Duaer Designer on a self-hosted instance

Self-hosted Duaer configures Duaer Designer in its setup wizard in Settings. Sandbox and web search are optional. Prepare environment variables before startup.

Deploy

Host Duaer with Docker

From Duaer v3, Docker is the only supported deployment. If the instance check finds you are not in a container, it opens this page.

Deploy

Set up task runners as an external process in Duaer

Duaer deprecates the internal task runner. Run the runner separately, set it to external, and share DUAER_RUNNERS_AUTH_TOKEN with the launcher.

Deploy

Configure binary storage with environment variables in Duaer

In Duaer, use environment variables for binary storage mode and path. The main process and workers must share one configuration.

Deploy

Configure security environment variables in Duaer

In Duaer, security switches such as SSRF are configured with environment variables. From v3 the default blocked IP ranges are wider, and the check links here.

Deploy

Configure digital-organization environment variables in Duaer

In Duaer, environment variables can set behavior such as the default caller policy. If the default is still any, the v3 check reports it and opens this page.

Deploy

Manage security policies in Duaer

In Duaer, the security page in Settings points docs here for instance-level security policy entry points.

More

Create and edit credentials in Duaer

In Duaer, credentials are stored on the instance and protected by the encryption key. Nodes reference a credential instead of putting secrets in parameters.

More

Use end-user credentials in Duaer

In Duaer, end-user credentials belong to the end user’s own connections. At runtime the triggerer’s account is used, not one shared secret.

More

Configure digital-organization settings in Duaer

In Duaer, settings include timezone, error handling, and caller policy. After v3 removes “Any workflow”, the check links to the who-can-call section.

More

Configure an embedded deployment in Duaer

When you embed Duaer in another product, configuration can overwrite credentials and related behavior.

More

Open the courses entry in Duaer

In Duaer, the Courses link in the product opens this page. It is an entry to practice notes, not a separate video school.

More

Understand how items flow in Duaer

In Duaer, this chapter explains what one input looks like and how a node runs with many items.

More

Looping docs moved in Duaer

In Duaer, legacy URL. Per-item execution and Execute Once are on the flow-logic looping page.

More

Use the Code node instead in Duaer

In Duaer, the Function node is removed. Write JavaScript in the Code node. This URL remains so old links are not empty.

AI

How Duaer Designer edits a workflow

Duaer Designer changes only the nodes you named, and it replies in the interface language selected in the sidebar. Attachments you reject leave the conversation.

AI

Check and rate what Duaer Designer delivers

Duaer Designer checks a built workflow against acceptance samples you confirm, and calls it verified only when every sample matches. After delivery, rate the reply with thumbs up or down and say what went wrong.

AI

Schedule a task for a Duaer digital employee

In Duaer, a digital employee task can run hourly, daily, weekly, monthly, or on a cron expression. A custom cron shows a readable sentence and the next run time.

AI

Install verified community nodes with Duaer MCP

In Duaer, a connected MCP client can install a verified community node. The client needs that permission, and it asks you before it installs.

AI

Connect Databricks Embeddings in Duaer

In Duaer, Embeddings Databricks is a sub-node on an AI node. It turns text into vectors.

AI

Set MiniMax output length in Duaer

In Duaer, MiniMax chat-model output length is Maximum Number of Tokens under the node’s Options. The ceiling follows the model you select.

AI recipes

Connect Claude to Duaer with MCP

Turn on the Duaer MCP server and add a custom connector in Claude, so Claude can find, run, and build your Duaer workflows.

AI recipes

Build a Duaer chatbot that answers from Google Drive docs

In Duaer, chunk the documents in a Google Drive folder into a vector store, then let an AI Agent retrieve the relevant pieces to answer each question.

AI recipes

Let AI draft Gmail replies to new emails with Duaer

In Duaer, each new email goes to a model that writes a reply, saved as a Gmail draft in the same thread. You review and send; the AI never sends for you.

AI recipes

Use DeepSeek models in a Duaer workflow

In Duaer, add your DeepSeek API key once, then plug deepseek-chat or deepseek-reasoner into an AI Agent or Basic LLM Chain.

AI recipes

Run local models with Ollama in Duaer

A self-hosted Duaer can reach Ollama on the same machine or network and plug open models such as Llama and Qwen into AI Agents and RAG, keeping data on your servers.

AI recipes

Auto-reply to WeCom app messages with AI in Duaer

In Duaer, when a member messages a WeCom self-built app, a model writes the reply and Duaer sends it back as an app message, optionally with memory.

AI recipes

Let Claude read and write Google Sheets through a Duaer MCP server

In Duaer, expose Google Sheets read and append as MCP tools with Duaer Server Trigger, so Claude can look up and add rows on request.

AI recipes

Translate one Excel column in bulk with AI in Duaer

In Duaer, upload a spreadsheet, translate one column row by row with Basic LLM Chain, merge the translation back, and export.

MCP

Connect AI tools to Duaer

Connect Claude, Claude Code, ChatGPT, Cursor, VS Code and Codex to the Duaer MCP server: the URL, how sign-in works, steps for each tool, scopes and common problems.