Quickstart

Before you start

Building an agent does not draw on your credit balance, so you can complete every step below before a customer sees it.

You need three things:

• A verified Duvi account. The agent list stays locked until you verify the email on the account.
• Content for the agent to read. Files, a website address, or both.
• Somewhere to paste a script tag. Your CMS, your theme, or a tag manager. There is no build step and no package to install.

Create an agent

1. Name the agent

   Open Agents and select New agent. Enter a name. Duvi creates the agent and opens its builder conversation, which is the default place to finish setup.

2. Choose a model and a voice

   Ask the builder to select a model, plus a transcriber and a voice if the agent will take calls. You can also open Configure and select them directly. Studio adds up the latency of all three so you can see what an answer costs in time before you commit to it. See Model and voice.

   Chat mode decides which controls the widget shows: text shows a message box, voice shows a call button, and both shows a message box with a microphone.

3. Write the system prompt

   Say what the agent does, who it is talking to, and what it must never do. Six short labelled sections work better than one long paragraph. See System prompt for the sections and a worked example.

   You answer questions about Duvi plans and credits for
   customers who already have an account.
   
   Answer only from the knowledge you were given. If the answer
   is not there, say so and offer to take their details.
   
   Never quote a price that is not in the price list.

Add knowledge

Open the Knowledge tab. Select files from your account library, or add a website address for the agent to crawl. You can use both on the same agent.

The crawler reads robots.txt first and takes its page list from the sitemaps declared there, so your site decides what gets indexed. See Knowledge for the full crawl rules.

Saving re-reads every source from the start. The agent keeps answering from its existing index while the new one builds, so there is no gap in service. The Knowledge tab shows one of four states: Pending, Indexing, Ready or Failed.

Wait until the status reads Ready before you judge an answer. Pending and Indexing need time. Failed needs you to inspect the source. See Indexing states.

Embed the widget

Open Appearance before launch if the widget needs your logo, a different color, a clearer launcher label or starter prompts. Appearance changes the website widget only; it does not change the agent’s answers. See Appearance.

Open Channels and copy the snippet. Paste it before the closing body tag on every page the agent should appear on.

<script src="https://ceronica.duvi.ai/scripts/chat-bot-widget.js" defer></script>
<digiiq-chatbot agent-id="YOUR_AGENT_ID"></digiiq-chatbot>

Then open Security and add your domain under allowed domains. Add the www version as well if you use it, because Duvi matches on hostname and treats them as separate entries. An empty list lets any site embed your agent. See Allowed domains.

Test the agent

Ask the agent five questions you already know the answer to, and one you know it cannot answer. Check two things: that it finds the right fact, and that it says it does not know rather than inventing an answer. See Testing for the full list, including the difficult conversations worth trying.

For symptoms across every part of the product, see Troubleshooting.