--- title: "Quickstart" description: "What you will build" canonical_url: "https://help.brainfi.sh/articles/quickstart-XeydM69fAt" md_url: "https://help.brainfi.sh/articles/quickstart-XeydM69fAt.md" --- # Quickstart ## What you will build At the end of the tutorial you will have: * One connected **source** continuously syncing into Brainfish. * One **published article** ranked and cited by the agent. * One **agent** embedded on a page you control, answering live queries. You will have touched four of the five pillars: **Integrate**, **Manage**, **Suggest** (optional), and **Distribute**. ## Before you start * **Plan:** available on all plans. * **Role:** Workspace admin. * **Prerequisites:** credentials for your chosen source; a test page or staging site where you can paste a `script` tag. ## Step 1 - Connect a source 1. Open **Knowledge → Sources**. 2. Click **Connect data source** and choose **Website** (for a quick test, the Brainfish home page or your own docs work). 3. Enter the URL, choose a crawl depth, and enable **Daily Sync**. 4. Click **Add Source**. The card appears on the Knowledge dashboard with a status indicator. ![Connect Source](https://help.brainfi.sh/api/attachments.redirect?id=2187af17-af59-4955-853a-96a17e535fa0 " =3014x1692") ![Select Source](https://help.brainfi.sh/api/attachments.redirect?id=6cc0c868-2e39-4606-876b-702b465d33b6 " =3024x1708") Within a minute, the source shows **Synced** with a document count. This is your **Integrate** pillar in action. ## Step 2 - Review and publish one article 1. Open **Knowledge → Articles**. 2. Filter by the source you just connected. 3. Open one article. Confirm content and metadata (title, summary, audience). 4. If it is a draft, click **Publish**. ![Publish CMS Article](https://help.brainfi.sh/api/attachments.redirect?id=4b35e742-0ab4-464b-86ed-2874e2c8ef17 " =3022x1688") You are now using the **Manage** pillar — articles only surface to agents after someone on your team has approved them. > **Optional (adds 2 minutes):** turn on **Suggest** by connecting a Slack workspace, then ask Brainfish to draft an article from a support thread. Approve it before moving on. ## Step 3 - Create and configure an agent 1. Open **Distribution → Agents**. 2. Click **Create agent** and pick **Web agent**. 3. Give the agent a name and optionally an identity (voice, persona, response length). 4. Click **Save**. ![Create Agent](https://help.brainfi.sh/api/attachments.redirect?id=5c40ee42-ec7c-4638-8153-071ea7d4815a " =2986x1690") ![Pick Agent Distribution](https://help.brainfi.sh/api/attachments.redirect?id=2095685d-dde5-4cd4-aa60-04009412481d " =3024x1708") ## Step 4 - Embed the agent on your page 1. In your new agent, open the **Install** tab. 2. Copy the provided `script` snippet. 3. Paste it into the `` of your test page (or your CMS's global script slot). 4. Reload the page. The agent appears. ![](https://help.brainfi.sh/api/attachments.redirect?id=b6e8362e-2667-49db-918d-e6c6d77c2e05 " =3010x1682") ## Step 5 - Ask it a real question 1. Open the test page. 2. Ask the agent something only answerable from the article you just published. 3. Confirm the response cites that article. ![](https://help.brainfi.sh/api/attachments.redirect?id=f66da0e3-176d-47c2-910e-ab71aea8f6f1) That citation is the **Distribute** pillar closing the loop back to **Manage**. Every answer traces to an approved article. ## What you just built ```mermaidjs flowchart LR Source[Connected source] --> Article[Reviewed article] Article --> Agent[Web agent] Agent --> Visitor[Customer question] Visitor --> Answer[Grounded answer with citation] ``` ## What to try next * **Ship to production.** Move the script tag from your test page to your live site. * **Bring your real content.** Connect Confluence, Zendesk, or Notion as a source under Knowledge → Sources. * **Turn on generation.** Go to Knowledge → Suggest to produce articles from real customer signals. * **Deploy to more channels.** Slack agent, Microsoft Teams, Chrome extension — all configurable under Distribution → Agents. * **Tune for enterprise.** Authenticated help centers, custom domain, and multiple help centers — see the Distribution section.