Train Lyro on Your Content

Lyro answers customer questions using the content you give it. This guide walks you through building a knowledge base, filling it from your docs and website, and connecting it to an agent so answers are accurate and traceable.

How training works

You train Lyro by adding content to a knowledge base and then attaching that base to an agent. When a question comes in, the agent searches the base, finds the most relevant passages, and writes its answer from them - citing the sources it used.

Each piece of content becomes an article. Articles are automatically split into smaller chunks and indexed for semantic search, so Lyro can match a customer's question to the right passage even when the wording is different.

Step 1 - Create a knowledge base

1. Open Knowledge in the dashboard.
2. Click New Knowledge Base.
3. Give it a Title (for example, "Product FAQ") and an optional Description.
4. Click Create.

Tip: Group content by topic or audience - for example, a "Returns" base and a "Setup" base - so you can attach only what each agent needs.

Step 2 - Add your content

Open the knowledge base to add articles. You have four ways to bring content in.

Upload documents

Click Upload File to import a .csv or .pdf.

Note: For CSVs, you can download an example file from the upload panel to match the expected layout.

Crawl your website

Click Crawl Website to pull in pages automatically. Choose a mode:

• Website - enter one URL; Lyro follows links to discover pages. Set Max pages and Max depth to control how far it goes.
• URL list - paste specific URLs (no link discovery).
• Sitemap - point to a sitemap.xml and every listed URL is crawled.

Under Advanced options you can add include and exclude patterns to keep the crawl focused. Each crawl handles up to 200 URLs; split larger sites across multiple runs.

Tip: Crawled articles appear in the list as pages are processed. You can close the panel and check back later, or open Crawl history to review past runs and any skipped URLs.

Write or edit articles

Click Add Article to author content yourself, or click any existing article to edit it.

• Edit the Title and write Content in the Markdown editor.
• Set the article Active to make it available to agents, or Inactive to hide it without deleting.
• Saved articles are re-chunked automatically so search stays current.

Note: Articles drafted by Lyro from gaps it finds appear as drafts. Review one and click Publish to make it live - this also resolves the related finding.

Step 3 - Find and manage articles

The knowledge base lists every article with its source type and status. To keep it tidy:

• Search by text, or switch to Semantic search to find articles by meaning.
• Filter by source (Manual, CSV, PDF, Web, API) or status (Active / Inactive).
• Select multiple articles to delete them in bulk.

Step 4 - Attach the knowledge base to an agent

Content only reaches customers once an agent can search it.

1. Open Agents and select an agent.
2. Go to the Knowledge tab.
3. Under Knowledge bases, toggle on the bases this agent should use.
4. Choose a Knowledge mode:

5. Save and publish the agent.

Note: With no bases selected, the agent has no knowledge to search and won't answer from your content. Toggle on at least one base.

Step 5 - Verify the answers

Test before customers do.

• Open the Playground and ask questions you expect customers to ask.
• Check that each answer cites a source - hover a citation to see the article and section it came from.
• If an answer is wrong or uncited, open the cited article to fix the content, or add a new one to fill the gap.

Tip: Use Strict mode while testing to surface gaps - any refusal points to content you still need to add.

Keep your content fresh

Training is ongoing. Re-crawl your site after major updates, edit articles when policies change, and review Findings regularly to see what customers asked that your content didn't cover. For a broader picture of where to focus, see Measure and improve.