Teach Astra about your business

You teach Astra in the Knowledge tab in the left sidebar — one knowledge base shared by every AI agent and by the inbox's suggested replies. The fastest way is Import website — Ody reads your site and organizes what it finds into one article. Click New article for anything your site doesn't say.

Since 2026-10-28 knowledge has its own tab with folders, an Available to AI switch and a per-agent audience — see Build your knowledge base in the Knowledge tab. The Knowledge base section of the AI agent screen still shows the same articles and still works (it's what the iPhone and Android apps use); the steps below work from either place.

Step-by-step: add your website

1. Click Knowledge in the left sidebar (or AI agent → your agent → the Knowledge section).

2. Click Import website (in the agent's Knowledge section: + Add URL). A card titled Learn from your website opens right there — no pop-up.

3. Type your site's address (for example www.yourbusiness.com — Ody adds https:// for you) and click Fetch.

4. Watch the progress card. It walks through five steps and shows live counts as it works:

   • Connect — checks the address and reaches your site.
   • Crawl pages — finds your main pages (home, about, services, pricing, contact, FAQ, booking, hours…) via your sitemap and links, up to 20 pages.
   • Read content — extracts the readable text from each page.
   • Organize — writes one clean knowledge file with sections for overview, contact & location, hours, services & pricing, booking, policies, team and FAQ.
   • Save — stores it and updates Astra.

5. When it finishes you'll see Astra learned about your site, with how many pages were read and how long the article is. Click View preview to read exactly what Astra now knows, or Download .md to keep a copy. Click Done to close the card.

This usually takes 20–40 seconds. You can keep working — the knowledge is saved when it's done.

Step-by-step: add typed knowledge

1. In the Knowledge tab click New article (in the AI agent tab's Knowledge base section: + Add text).

2. Give the article a title (for example, "Hours & pricing") and type the body — anything the AI should know when talking or texting with customers. Markdown works in the Knowledge tab.

3. Click Save (Save knowledge in the AI agent tab). The article appears in the list with its size and a green dot.

Each article can hold up to 20,000 characters, and you can add several. Keep articles focused — one topic per article — for the best answers.

Managing your knowledge

• In the Knowledge tab, click an article to open and edit it; use its Available to AI switch to hide it without deleting; put articles in folders; set Who can read it when you run several agents (Choose which AI uses an article).
• If your site changes, open the website article and click Re-read site (Import your website into Knowledge).
• In the AI agent tab's Knowledge base section, website entries show as Website · N pages · N characters · yoursite.com; click to expand, × to remove. When you have more than four articles, the list shows the first four and a Show N more articles button — tap it to see the rest, Show fewer to collapse again, so greeting and jobs stay nearby. The Knowledge tab still lists every article.
• Everything is updated on the live agent automatically — you don't need to click Publish after adding, editing or removing knowledge.
• The iPhone and Android apps add and remove knowledge from their AI agent screens (a flat list — folders and the audience picker are web for now; the website fetch there runs without the progress card and returns when it's done).

Troubleshooting

• "We couldn't reach that site" or "That site blocked us" — the site's firewall or bot protection turned away the reader, or the address is wrong. Check the spelling, try the www. version, or paste the key facts with + Add text.
• "We couldn't find readable text on that site" — the site is built entirely in JavaScript or is mostly images. Ody automatically tries a second reading method before showing this; if it still appears, add the facts as text.
• Fewer pages than expected — Ody reads up to 20 pages per fetch and prefers pages about hours, services, pricing, contact and booking over blog posts and language variants. If an important page was skipped, add a short text entry for it.
• Some facts are wrong or outdated in the article — a website article only contains what your site says. Fix the site and Re-read site, edit the article directly, or add a separate article: Astra is told to use the most specific information it has.
• Private or internal addresses (localhost, 192.168…, intranet hosts) can't be fetched. Only public websites work.

What the knowledge powers

• Astra on calls — every AI agent answers questions about hours, services, pricing, policies and contact details only from the articles it can read, quoting numbers and prices exactly as written.
• AI suggested replies in the inbox — text drafts grounded in the same knowledge. See AI suggested replies.

One knowledge base, every AI, both channels — add it once.

Related articles

• Build your knowledge base in the Knowledge tab
• Choose which AI uses an article
• AI suggested replies
• Astra jobs: what it can do
• Meet Astra, your AI receptionist