Quick Start

From zero to a working chat widget in five minutes. You will need an account and a PDF document about your product, policies, or processes.

1. Create your organisation

Sign up at the Bounds console and create an organisation. All agents, documents, and databases live inside an organisation and are isolated from other accounts.

2. Upload a document

Go to Databases and upload a PDF (max 50 MB). Bounds analyses and indexes it automatically in the background - the document status moves from pending to processing to completed within seconds for most files.

3. Create a database

Go to Databases → Databases and create a new database. Give it a name that describes its contents (for example, Product FAQ or Returns Policy). Add the document you uploaded in step 2.

4. Create an agent

Go to Agents and create a new agent. On the Databases tab, attach the database you just created. Save the agent and copy the public key - it starts with agt_. This key is safe to use in client-side code.

5. Embed the widget

Paste this snippet before the closing </body> tag of your site, replacing the placeholder with your actual agent key:

<script
  src="https://cdn.bounds.ai/widget.js"
  data-agent-id="agt_your_key_here"
  defer
></script>

That is all that is required for an anonymous widget. Users can start chatting immediately without creating an account.

6. Open your site and test it

Reload the page where you added the script. The Bounds chat button appears in the bottom corner. Ask a question that your uploaded document covers and confirm the answer is accurate and cites the right source.

What happens next

Your widget is live. From here you can customise the widget appearance, add more documents and databases, connect your own backend via actions, or enable signed sessions so the agent can look up data specific to each logged-in user.