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.

What’s new in the docs

New and updated guides to help you set up, troubleshoot and improve your agent.

Customize the website widget appearance
The new Appearance guide covers the launcher, color, logo, label, starter prompts and what to check before saving.
appearance
Use the builder with the agent sections
The builder guide now matches Studio: describe the agent in Builder, then use Configure, Integrations, Tools and the other sections for exact edits.
builder
Connect services from Integrations
Connector setup now points to the Integrations section and provider pages, where Studio shows the service description, tools and connection form.
connectors
Find a fix when your agent is not working
Use the new troubleshooting guide to check missing answers, failed indexing, widget issues and connection errors.
troubleshooting
Check your files before uploading
The new file types guide explains which formats your agent can read, how to prepare unsupported files and how the 5 GB storage allowance works.
reference/file-types
Understand the terms you see in Studio
Look up agent settings, knowledge states and conversation labels in the new glossary.
glossary
Rotate your customer identity signing keys
Learn how to add a replacement key, update your identity endpoint and select the key Duvi uses to verify customer tokens.
identity
Prepare to connect website, phone and WhatsApp
Check the setup requirements for each channel before connecting your agent, including the accounts and credentials you need.
channels
Help your agent find the right website content
Learn how your website address, sitemap and robots.txt affect which pages Duvi reads, and check why content may be missing.
knowledge
Choose which websites can use your agent
Follow the allowed domains guidance to restrict access to your websites, including when to add the www hostname separately.
security
Give visitors a next step when your agent cannot help
Use the expanded prompt guidance to offer a contact link, collect details for follow-up or call an HTTP action you have configured.
leads
Write clearer instructions for your agent
Use the six-part prompt guide to define the job, set boundaries and write replies that work aloud for voice conversations.
system-prompt
Find out why an answer went wrong
The expanded retrieval trace guide helps you check which source passages Duvi finds and decide whether to update your knowledge or prompt.
retrieval-trace
Test your agent before customers use it
Work through six test questions, difficult conversations and a pre-launch checklist in Preview, on desktop and mobile.
testing
Use conversation feedback to improve your agent
Understand outcomes, issues, sentiment and quality scores, and use the answer quality reference to identify what to fix.
reference/answer-quality

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 voice3 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 answers2 min
The five steps between a customer question and a Duvi agent reply: retrieval, prompt assembly, tool calls and the response.
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, and reach them on every channel.

Agent capabilities3 min
What a Duvi agent can do in a conversation: grounded answers, screen control on your website, verified links, saved details, 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.

Launch

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

Test an agent3 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.
Troubleshooting7 min
Symptoms and causes across Duvi agents: bad answers, indexing failures, a widget that will not appear, tool errors, identity problems and credits.

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 widget1 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.
Glossary3 min
Every term these Duvi docs use, the label Studio shows on screen for the same thing, and what each one means.

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