Help Center

Step by Step

• Go to your Dashboard and click AI Agent Studio in the sidebar, then click New Agent.
• Choose the agent type. Pick Chat for a conversational agent (customer support, FAQ bot, lead capture) or Task for background automation (data processing, content generation).
• Name your agent and write a clear system prompt. The system prompt tells the agent how to behave. For example:

> "You are a friendly customer support agent for an online store. Answer questions about shipping, returns, and product availability. If you don't know the answer, offer to connect the customer with a human agent."

• Pick a model. Claude Sonnet is the default and works great for most use cases. Claude Haiku is faster and cheaper for simpler tasks. You can always change this later.
• Set a welcome message. This is the first thing visitors see when the chat opens. Something like: "Hi! How can I help you today?" works well.
• Test in the preview panel. The live preview on the right side lets you chat with your agent before deploying. Send a few messages to make sure it behaves how you want.
• Deploy! Once you're happy, switch the status to Live. Your agent is now ready to embed on your website.

Tips for Beginners

• System prompt is the most important setting — spend time getting it right.
• Suggested questions help guide visitors. Add 2-3 common questions.
• You start with free credits on signup, enough to test and go live.
• You can always edit your agent later — nothing is permanent.

The Quick Way: Chat Bubble Widget

The easiest way to add your agent is with a single script tag. It creates a floating chat bubble in the corner of your website.

• Go to your agent's page in the dashboard and click the Embed tab.
• Copy the Widget code. It looks like this:

<script
  src="https://your-domain.com/api/embed/widget.js"
  data-agent-id="your-agent-id"
></script>

• Paste it into your website's HTML, just before the closing tag.
• That's it — the chat bubble will appear on your site.

Optional Attributes

• data-position="left" — Move the bubble to the bottom-left corner (default is bottom-right).
• data-greeting="Need help? Chat with us!" — Show a greeting tooltip next to the bubble.

Advanced: iFrame Embed

If you want to embed the chat as an inline element (not a floating bubble), use the iFrame code from the Embed tab instead. This places the full chat widget directly in your page layout.

<iframe
  src="https://your-domain.com/embed/your-agent-slug"
  width="400"
  height="600"
  style="border: none;"
></iframe>

Troubleshooting

• Chat not appearing? Make sure the agent status is set to Live.
• Styling conflicts? The widget loads in an iframe, so your site's CSS won't affect it.
• Custom domain? You can set up a custom domain in the agent's White-Label settings (Pro plan).

What is the Knowledge Base?

The Knowledge Base is how you give your agent information about your business. When a visitor asks a question, the agent searches the knowledge base and uses that information to craft accurate, relevant answers.

How to Add Knowledge

Go to your agent's page and click the Knowledge tab. You have three options:

1. Upload PDFs

Click Upload and select a PDF file. KILN will extract the text, split it into chunks, and make it searchable for your agent. Great for:

• Product manuals
• Policy documents
• Pricing sheets

2. Add URLs

Enter a webpage URL and KILN will scrape the content. Perfect for:

• Your FAQ page
• Product pages
• Blog posts with relevant info

3. Add FAQ Pairs

Manually enter question-answer pairs. This gives you the most control. Ideal for:

• Frequently asked questions
• Specific responses you want word-for-word
• Edge cases the agent should handle a certain way

Tips

• Start with your FAQ page or existing documentation — it usually covers the most common questions.
• Quality over quantity. A few well-written FAQ pairs often beat a massive PDF.
• Test after adding. Use the preview chat to ask questions and verify the agent finds the right information.
• Each knowledge entry uses embedding credits once when added. Querying it later is free.

How Credits Work

KILN uses a credit system for AI operations. Every message your agent sends, every task it runs, and every knowledge base entry it processes costs credits.

Action	Approximate Cost
Chat message (Sonnet)	~1-3 credits
Chat message (Haiku)	~0.5-1 credits
Task execution	~2-5 credits
Knowledge embedding	~1 credit per chunk

Free Credits

Every new account starts with free credits — enough to create your first agent, add some knowledge, and run real conversations with visitors.

Checking Your Balance

Your remaining credits are shown in the top banner of the dashboard. You can also see detailed usage in Settings.

When to Upgrade

If you're running out of credits regularly, it's time to upgrade:

• Pro (€49/month) — More credits, white-label options, custom domains
• Agency (€149/month) — High-volume credits, multiple agents, priority support

You can upgrade anytime from Settings → Billing.

Get Notified About New Leads

KILN can send you an email whenever a new conversation starts with one of your agents. This way you never miss a potential lead.

How to Enable

• Go to Settings in the dashboard sidebar.
• Find the Preferences section.
• Toggle Email Notifications on.

That's it! You'll receive an email each time a visitor starts a new conversation with any of your live agents.

What Triggers an Email

• New conversation started — When a visitor sends their first message to your agent.

How to Turn Off

Go to Settings → Preferences and toggle Email Notifications off. You'll stop receiving emails immediately.

Note

Emails are sent to the address associated with your KILN account. Make sure your account email is correct in your profile settings.