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
- Open Settings > Agents.
- 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
- Open Usage and limits on that agent.
- 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
- 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.
- 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.
- 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.
- 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.
- 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
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.
AIUse 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.
AIRetrieve 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.
AIUse $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.
AIUnderstand why to evaluate in Duaer
In Duaer, use evaluations against known test cases so AI workflows stay reliable across inputs.
AIRun 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.
AIUse 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.
AIFix common evaluation issues in Duaer
In Duaer, when triggers, field maps, or chat output fight the evaluation nodes, check the wiring first.
AITurn 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.
AIDraft 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.
AIFix 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.
AIConnect an MCP client to Duaer
After MCP access is on in Duaer, put the connection URL and auth into the client config.
AIUse Duaer Designer on cloud
Duaer Designer on cloud is toggled in Settings and helps edit workflows.
AIManage MCP access on Duaer cloud
After you turn on MCP access on a Duaer cloud instance, outside clients can connect.
DeploySet 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.
DeployHost 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.
DeploySet 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.
DeployConfigure 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.
DeployConfigure 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.
DeployConfigure 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.
DeployManage security policies in Duaer
In Duaer, the security page in Settings points docs here for instance-level security policy entry points.
MoreCreate 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.
MoreUse 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.
MoreConfigure 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.
MoreConfigure an embedded deployment in Duaer
When you embed Duaer in another product, configuration can overwrite credentials and related behavior.
MoreOpen 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.
MoreUnderstand how items flow in Duaer
In Duaer, this chapter explains what one input looks like and how a node runs with many items.
MoreLooping docs moved in Duaer
In Duaer, legacy URL. Per-item execution and Execute Once are on the flow-logic looping page.
MoreUse 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.
AIHow 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.
AICheck 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.
AISchedule 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.
AIInstall 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.
AIConnect Databricks Embeddings in Duaer
In Duaer, Embeddings Databricks is a sub-node on an AI node. It turns text into vectors.
AISet 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 recipesConnect 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 recipesBuild 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 recipesLet 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 recipesUse 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 recipesRun 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 recipesAuto-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 recipesLet 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 recipesTranslate 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.
MCPConnect 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.