Docs

Duvi documentation

Build an AI voice and chat agent that answers from your own content, acts through your connected systems, and runs on your website, your phone number and WhatsApp.

Start here

Pick the task that matches what you are doing. Each one links to the page that covers it in full.

index.html
```
<digiiq-chatbot
  agent-id="YOUR_AGENT_ID">
</digiiq-chatbot>
```
Put it on your site
One script tag and one element, before the closing body tag. There is nothing to install and no build step.
Quickstart, 4 min
builder
```
You
answer pricing questions, take an
email if you cannot help

Duvi
Prompt and greeting set.
```
Build it by talking
The builder writes the prompt, selects the model and adds knowledge as you describe the job.
Agent builder, 2 min
http action
```
POST /orders/lookup

order_id   Ask the customer
email      From the signed-in customer
api_key    Stored key
```
Connect your systems
Connectors for services you already use, plus any HTTP endpoint or MCP server you point it at.
Tools, 3 min

For coding agents

Every page is also published as Markdown, so a coding assistant can read the documentation directly.

Give an agent the full documentation

Paste this into Claude Code, Cursor, Codex or anything else that can fetch a URL.

agent prompt

Read https://www.duvi.ai/docs/llms.txt for the index of Duvi's
documentation, then read the pages relevant to my task. Build me a
Duvi agent that answers from my product pages and books a call. Ask
me for the agent id before you write the embed snippet.

/docs/llms.txt /llms-full.txt /llms/docs/quickstart.md

The first lists every page. The second is every page in one file. For a single page, put /llms in front of its address and .md after it.

All documentation pages

Every page, grouped by stage and annotated. Follow the groups in order the first time, then jump to the stage you are in.

Build

Create an agent, write its prompt, and give it knowledge to answer from.

Quickstart4 min
Create a Duvi AI agent, index your files and website as knowledge, and embed the chat widget on your site with one script tag.
Agent builder2 min
Build a Duvi agent by describing the job in a conversation, then use the agent sections for exact control over every field.
System prompt8 min
Write a Duvi system prompt in six blocks, keep facts in knowledge, give every rule a reason, and tune the prompt for voice.
Model and voice5 min
Choose a transcriber, model and voice for a Duvi agent, read the combined latency estimate, and hit the latency targets that matter on a call.
Appearance1 min
Customize the website widget launcher, color, logo, label and starter prompts, then preview the real widget before launch.
Knowledge4 min
Add files and websites as Duvi agent knowledge, understand the four indexing states, and fix an index that returns nothing.
Files1 min
Upload files to the account-wide Duvi library, organize them into folders, attach them to agents as knowledge, and manage the 5 GB allowance.
How an agent answers3 min
The five steps between a customer question and a Duvi agent reply: retrieval, prompt assembly, tool calls and the response, and how Duvi summarizes long conversations.
Retrieval trace3 min
Run a search against a Duvi agent index and read the exact passages retrieval returns, with the source behind each result.

Connect

Connect your systems, verify your customers, reach them on every channel, and hand over to your team.

Agent capabilities4 min
What a Duvi agent can do in a conversation: grounded answers, screen control on your website, verified links, saved details, handover to a person, withheld messages, and what each channel supports.
Tools3 min
Give a Duvi agent live data through HTTP actions, MCP servers and connectors, and control values, stored keys and per-customer access.
Connectors2 min
Connect Shopify, Stripe, Notion and other services to a Duvi agent, choose which of their tools it may call, and read the connection states.
Customer identity4 min
Verify signed-in visitors with a JWT from your own server, restrict a Duvi agent to signed-in customers, and pass verified claims into tool calls.
Channels3 min
Connect a Duvi agent to your website, a Twilio phone number and a WhatsApp Business number, including webhooks and the provider handshake.
Human handover3 min
Let a Duvi agent pass a conversation to a person on your team: connect an organization, choose the channels that accept handover, and see what the customer sees.

Launch

Test the agent, restrict who can reach it, and diagnose what goes wrong.

Test an agent4 min
Test a Duvi agent in Preview before launch: six questions to ask, the difficult conversations to run, and a pre-launch checklist.
Security and access3 min
Restrict a Duvi agent to your own domains, require a signed-in visitor, show an AI disclaimer, and store credentials as encrypted keys.
Troubleshooting9 min
Symptoms and causes across Duvi agents: bad answers, indexing failures, a widget that will not appear, tool errors, identity problems, handover and credits.

Team

Bring in the people who take over from your agent, and answer handed-over conversations.

Organizations2 min
Create a Duvi organization for the team that answers customers: its sections, who can open each one, its own phone and WhatsApp numbers, and how agents hand conversations to it.
People and roles2 min
Invite people to a Duvi organization, give each one a role, compare the Owner, Supervisor, Agent and Auditor roles, and create a custom role.
Inbox3 min
Answer conversations your Duvi agent handed over: take one from the queue, read why the agent handed over, reply or leave a note, attach files, and close it.
Routing and availability2 min
How Duvi offers waiting conversations to your team: who receives an offer, how long it lasts, capacity per person, and the timers that close or abandon a conversation.
Hours and messages2 min
Set your Duvi team's working hours, time zone and holidays, and write the automatic replies customers receive while they wait, when you are closed and when a conversation ends.
Saved replies and categories1 min
Write Duvi saved replies your team inserts with a slash shortcut, and create the categories that label what each conversation was about.

Operate

Review conversations, leads, usage and account settings.

Conversations and insights2 min
Read Duvi transcripts, conversation volume, response latency, tool timing, outcomes, sentiment, topics and the poorly answered queue.
Leads3 min
Read the name, email, phone and location a Duvi agent captured in conversation, and send new leads straight into your CRM with an HTTP action.
Credits and usage3 min
How Duvi credits are consumed, where to read usage and burn rate, what happens when the balance reaches zero, and how to set up automatic top-up.
Account and sessions1 min
Sign in to Duvi Studio, verify your email, reset a password, update your profile, revoke device sessions and check account storage.

Reference

Exact contracts for the widget, actions, file types and quality codes.

Website widget2 min
Reference for the Duvi website widget: the script and custom element, every attribute, page variables, conversation threads, ratings and frame isolation.
HTTP actions3 min
Reference for Duvi HTTP actions: every field on the definition, the five value sources, the eleven reference types, and what the agent does when a call fails.
Supported file types3 min
Every file format Duvi extracts text from, the formats that index as nothing, the 5 GB storage allowance, and how the web crawler reads pages.
Answer quality2 min
Every outcome, issue code, sentiment value and quality score Duvi records against a conversation, and what each one usually points at.
Glossary5 min
Every term these Duvi docs use, the label Studio shows on screen for the same thing, and what each one means.

33 pages. Every page is also available as Markdown for an agent to read.