Skip to content

Chatbots

Instructions, model settings, knowledge and the publish flow.

A chatbot is the simplest assistant: instructions, a model, optional collections, and an appearance. It streams answers and cites the sources it used.

Instructions

The Instructions tab is the system prompt sent on every conversation. Say who the assistant is, what it should do, how to behave when it does not know, and when to hand off to a human. Instructions are capped at 20,000 characters.

Example instructions
You are the support assistant for Acme, a company that sells lab equipment.

- Answer from the connected collections and cite the sources as [n].
- If the knowledge does not cover the question, say so and offer to pass it to
  a human rather than guessing.
- Never quote a price; prices change, so link to the pricing page instead.
- Keep answers under four sentences unless asked for detail.

Model settings

Pick a model tier, a temperature between 0 and 2, and a maximum reply length. Model identifiers are routed by the AI gateway rather than hard-coded into the product, so the same chatbot can be pointed at a different provider without changing its configuration.

Welcome message

The first message a visitor sees. It is not sent to the model and does not count towards usage.

Knowledge

Attach any number of collections from the same workspace. On every turn the most relevant chunks are retrieved and passed to the model, which cites them as numbered sources. See knowledge.

Status

StatusBehaviour
DraftEditable, testable in the playground, invisible to visitors.
ActiveServing the widget and the API.
PausedConfiguration kept, but it stops answering immediately.
ArchivedHidden from lists and disabled.