Skip to main content

Quickstart

Biel.ai adds AI-powered chat and search to your documentation site. Users ask questions in plain language and get answers drawn from your content — instead of browsing pages or filing support tickets.

In this tutorial, you create a Biel.ai account, index your documentation, and test the assistant from the dashboard. Later, you can embed the assistant or search widget on your site.

1. Create your Biel.ai account​

The standard 14-day trial includes Business features, 10,000 indexed pages shared across your team, 25,000 monthly interactions, and unlimited projects. See Manage subscription for usage and billing details.

  1. Open app.biel.ai.

  2. Click Sign up.

  3. Enter your Work email and Password. You can also add your Name and Company name.

  4. Accept the Terms of service and Privacy policy, then click Create account.

  5. Open the verification link in your email to activate your account.

    Create account

2. Create a project​

A project groups your content sources and powers the assistant. Each project has its own index, settings, and analytics.

  1. In the dashboard, click Projects > Create project.

  2. Enter a Name for your project.

  3. Add one or more Sources to index:

    Source typeDescription
    URLsIndividual webpages, such as https://docs.biel.ai/.
    SitemapsMultiple pages from a sitemap URL.
    GitHubDocumentation files from a repository.
    OpenAPIAPI documentation from an OpenAPI specification URL.
    ConfluencePages from a Confluence space.

    To use Files, create the project first, then upload your documents in Settings > Sources > Files.

    Create project

  4. Click Create project. If you added only one URL, click Proceed anyway in the coverage warning, or cancel to add more sources.

  5. On Install the widget, choose AI Assistant or AI Search. Preview the widget and optionally expand Customize appearance.

    Install the widget with a preview and appearance options

  6. Under Add to your website, use Copy code to copy the snippet for your website. You can install it later.

    Copy the installation code for your website

  7. Click Continue to test.

Biel.ai crawls and indexes your sources while you set up the widget. The next screen shows Your project is ready to test when processing finishes.

3. Test the assistant​

Now that your content is indexed, verify that the assistant returns accurate answers:

  1. On Test your project, click Test assistant.

  2. In the chat window, type a question about your indexed content and click Send.

    My first chat

Close the chat window, then click Go to project to view your saved conversations and settings. You can start another test from New chat on the project dashboard. The dashboard shows Sources loading during a crawl and Sources loaded when it finishes.

Not getting good answers?
  • Check Logs to verify that your sources were indexed correctly.
  • Adjust the assistant behavior in Settings.
  • Click Refresh sources to re-crawl your content.

Next steps​

Your project is ready. Choose how you want to surface it to users:

  • Assistant widget — Embed an AI chat button on your site. See the Installation guides for your platform.
  • Search widget — Add an AI-powered search bar instead of (or alongside) the assistant. See Install biel-search.
  • MCP server — Let developers query your docs from AI coding assistants like Claude or Cursor. See MCP Server.
  • Integrations — Connect Biel.ai to GitHub Actions, ChatGPT plugins, Zapier, and more. See Integrations.