Setup
From asking for a plan to your first answer on your own website — in the order it actually happens.
The whole path
Most of this is quick. Two things are not in your hands: someone at Tigerbase approves your plan, and a document has to be read before the agent can answer from it. Everything else you do yourself, in this order.
| 1 · Request a plan | You. Your request waits for approval. |
|---|---|
| 2 · Approval | Tigerbase. Until then you can set up, but nothing runs. |
| 3 · Create the agent | You. You get a public key and a one-time secret. |
| 4 · Say where it lives | You. Add your website under Allowed Domains. |
| 5 · Decide who pays for the model | You, if your plan asks for your own key. |
| 6 · Give it something to read | You. Upload documents; they are indexed in the background. |
| 7 · Make it look like yours | You. Colours, name, opening line. |
| 8 · Put it on your site | You. One script tag. |
| 9 · Check it works | You. Ask something only your documents can answer. |
- 1
Ask for a plan
Sign in and pick a plan from the pricing page or from My Apps. If you have a coupon, enter it here — it takes the first term down by the amount it promises.
What you have made is a request, and it shows as Pending. Nothing is charged automatically: each request is approved by a person at Tigerbase.
- 2
Wait for approval — and what you can do meanwhile
While the request is pending, every page of your app shows a Waiting for approval banner, so nothing looks broken.
You can Create the agent, set its name and colours, add your Allowed Domains, add your own AI key, write the opening line. You cannot yet Run the agent from the dashboard, upload documents, or use the AI tool builder. Visitors to your website get no answers. Those are switched off because they spend model capacity, and that starts once the request is approved. When it is, the banner goes away and everything works.
- 3
Create your agent
Approval gives you an app; the app has no agent until you make one. On any page of it you will see a You have not created your agent yet card — press Create agent and give it a name.
You are shown two credentials, once:
API key Public. It identifies the agent and goes in the script tag on your website. You can always see it again under Settings → API Credentials. Secret Private, and shown only now — we keep just a hash, so it cannot be shown again. A website tag does not need it. Copy it somewhere safe or leave it; you can regenerate it later. How many agents you can have depends on your plan (see Plans and limits).
- 4
Tell it which site it lives on
Open Settings → Allowed Domains and add the site the agent will be embedded on. This is required: an agent with no allowed domain refuses to answer on a live site, on purpose — an empty list would mean the key works on any website that copies it.
example.com That site (and only that host). *.example.com The site and every subdomain of it. https://example.com Also accepted; it is reduced to its host. localhost Always accepted once the list has at least one entry — for testing on your own machine. Press Save. Whatever you have typed in the box when you press it is included, so you do not need the + first.
- 5
Decide who pays for the model
Open Settings → AI Key. What you see depends on your plan:
Your plan includes shared capacity The agent answers on Tigerbase's quota until you add a key of your own. Adding one is optional. Your plan asks for your own key The agent will not answer until you add one. The page says so plainly. Today the provider is Google Gemini; others are on the way and are shown as coming soon. A key you add is encrypted, is never sent back to your browser, and is used alone: if it runs out of quota, the agent stops rather than quietly switching to ours. Add more than one and they rotate.
Get a Gemini key
Create one in Google AI Studio and paste it in. A key from a newer Google account may not be offered some older models; Tigerbase moves to one your key can use on its own. - 6
Give it something to read
Open Resourcesand upload documents — PDF, Word, plain text or Markdown, up to your plan's file size. They are cut into passages and indexed in the background; a document appears in the list at once, but it is only searchable once indexing has finished, which takes a moment for a short file and longer for a big one.
Everything the agent tells a visitor about your business comes from here, so write the documents the way you would answer a customer. The Knowledge page explains what happens to a file and why an answer can still be wrong.
- 7
Make it look like yours
Settings → Appearance sets the colour, position, corner radius and font; Opening line sets the greeting that appears beside the closed button. Each card has its own Save button, and a change is not kept until you press the one on the card you edited.
- 8
Put it on your site
Paste one tag into your pages, using your agent's key (from Settings → API Credentials):
html<script src="https://cdn.tigerbase.cloud/v2" data-api-key="tb_your_agent_key" defer ></script>Use one agent per page. Different pages or sites can each carry a different agent — each with its own key and its own Allowed Domains.
- 9
Check that it works
Open your site, press the button and ask something only your documents can answer — a price, an opening time, a policy. A correct answer means the whole chain works: the key, the domain, the plan, and the reading.
To watch it think, use Pipeline → Run in the dashboard: it shows which passages were read and which tools were called.
Optional, when you are ready
| Tools | Let the agent look something up in your systems or do something, not just answer. Read more. |
|---|---|
| Human handoff | Let it pass a conversation to a person, from your inbox or your own helpdesk. Read more. |
| Team members | Invite colleagues with only the permissions they need. |
When something does not work
| “This agent has no allowed domains configured” | Step 4. The list is empty or was not saved. Add your site and press Save. |
|---|---|
| “Origin domain … is not allowed” | Step 4. The site the visitor is on is not in the list — add that exact host. |
| “Subscription is not active” | Step 2. The request is still pending, or the term has ended. Once approved or renewed it works. |
| The agent will not answer and the AI Key page says a key is required | Step 5. Your plan asks for your own key; add one. |
| It answers, but not from my documents | Step 6. The document may still be indexing, or the answer is not in it — see the Knowledge page. |
| I changed the colour and nothing happened | Step 7. Press Save on that card, then refresh the page hard (Ctrl+F5) — the browser keeps the widget. |
| Visitors see “Something went wrong” | The reason is in your dashboard's Logs. The most common: a missing or exhausted AI key. |
Approval is manual today
Keep your secret secret
Next
Agents — what an agent decides on its own