Reference / Reference

Glossary

One word per idea, and the label Studio puts on screen for it. Where these docs and the product have used two words for one thing, this page is the one that wins.

Agent terms

TermOn screenWhat it means
AgentAgentOne assistant: its prompt, its knowledge, its tools and the channels it answers on. The unit everything else attaches to.
System promptSystem prompt, in the Behaviour panel on ConfigureStanding instructions about how to behave. Sent with every exchange. Not the place for facts. See System prompt.
First messageFirst messageWhat the agent opens with, before the customer has said anything. Older wording called this the greeting.
DisclaimerDisclaimerA standing line shown before the first message, saying replies are generated. Off until you turn it on.
Chat modeText only, Voice only, Text and voiceWhich controls the website widget shows. It does not change what the agent knows or can do.
AppearanceAppearanceThe widget’s launcher, color, logo, label and starter prompts. See Appearance.
BuilderBuilderThe conversation that configures an agent for you. The agent sections remain available for exact edits.

Knowledge terms

TermOn screenWhat it means
KnowledgeKnowledgeEverything an agent may answer from. Two kinds: files picked from your library, and websites saved on the agent.
SourceFiles, WebsitesOne file or one website address you added.
IndexIndex, with a state beside itThe searchable form of your sources. Rebuilt from scratch whenever you save.
Index statePending, Indexing, Ready, FailedOne state for the whole agent, not one per source. See Indexing states.
PassageA result in a traceA fragment of a source. Retrieval returns passages rather than whole documents, which is why a long price list costs nothing to keep.
RetrievalSearching the index for the passages that match a question, and sending only those to the model.
Retrieval traceThe panel on the Knowledge tabA search you run yourself, showing what retrieval returns and where each passage came from. See Retrieval trace.
Top KTop KHow many passages a trace asks for. One to twelve, eight by default.
GroundingThe rule that an agent may only present something it can point at a source for.

Tool terms

TermOn screenWhat it means
ToolToolsAnything the agent can call during a conversation. Covers all three kinds below.
ActionActionOne HTTP request to an endpoint of yours, shaped field by field. See HTTP actions.
MCP serverMCP serverA server that publishes its own set of tools. A wider grant than a single action.
ConnectorIntegrationsA service Duvi already knows how to talk to, such as Shopify or Stripe. See Connectors.
Value sourceAsk the customer, Fixed value, From the signed-in customer, From your website, Stored keyWhere one field on a tool call gets its value. The setting that decides whether a customer can read another customer’s record.
Stored keyStored keyA secret saved once against an agent, referenced by name afterwards and never shown again.
Page variablevariables on the embed elementContext your own page hands the widget. Visible to the visitor, so never proof of anything.

Channel and access terms

TermOn screenWhat it means
ChannelWebsite, Phone, WhatsAppHow a conversation reaches the agent.
WidgetWebsiteThe script tag and element you paste on your own pages. See Website widget.
Agent idThe id in the snippetNames which agent answers. Public, and not a credential. See The agent id is public.
Allowed domainsAllowed domainsThe domains permitted to open a conversation. An empty list allows every site. Older wording called these allowed origins.
AccessAnyone, Only signed-in visitorsWho may open a conversation at all.
Customer identityCustomer identitySigned proof from your own server about who the visitor is. The only thing that counts as proof. See Customer identity.
Saved detailsLeadsWhatever the customer typed or said. Useful, and proof of nothing.

Conversation terms

TermOn screenWhat it means
ConversationConversationsOne exchange with one customer, kept in full.
LeadLeadsA conversation the agent came away from with an email address or a phone number. See Leads.
OutcomeResolved, Unresolved, Enquiry taken, Abandoned, Off topicWhat the conversation was. Exactly one per conversation.
IssueMade something up, No answer, Wrong information, Off topic reply, Repeated itself, Poor formattingWhat went wrong. Any number per conversation, including none.
Quality scoreA number out of fiveDuvi’s assessment of the conversation. Not the same as the star rating, which is the customer’s. See Answer quality.
CreditCreditsThe unit the account is billed in. One balance for every agent and every channel. See Credits.