Tutoriál: Vytvořte znalostního bota pro Confluence

V tomto tutoriálu vytvoříte interního znalostního bota, díky kterému váš tým najde informace ve vaší Confluence wiki okamžitě. Místo proklikávání stránek a prostorů se prostě zeptá.

Scénář: Vaše firma používá Confluence pro interní dokumentaci: inženýrské runbooky, produktové specifikace, HR směrnice, návody pro nástup. Najít tu správnou stránku chvíli trvá. Chcete chatbota, který wiki zná od A do Z.

Potřebný čas: Zhruba 20 minut nastavení. Samotné procházení pak běží na pozadí a u velké wiki může trvat několik hodin.

Co se naučíte:

Jak připojit Confluence, včetně wiki za SSO
Jak ji místo toho procházet jako web, pokud se to hodí víc
Jak Confluence doplnit o PDF manuály
Jak nastavit soukromého bota pro interní použití
Jak se připojit přes MCP, aby vaši wiki mohly prohledávat i vývojářské AI nástroje

Než začnete: zvolte způsob připojení

Obsah z Confluence lze do ChatbotIQ dostat dvěma způsoby a jeden je téměř vždy lepší.

Použijte konektor Confluence. Čte wiki přes rozhraní Atlassian API pomocí API tokenu. SSO nevadí, vyberete přesně, které prostory se indexují, ve vyhledávání získáte hierarchii stránek a opakované synchronizace znovu načtou jen skutečně změněné stránky. Postup najdete v článku Jak připojit Confluence; potom přejděte na krok 2 tohoto návodu.

Procházejte ji jako web. Stojí za zvážení jen tehdy, pokud je wiki čitelná i bez přihlášení. Otevřete některou stránku v anonymním okně prohlížeče: pokud skončíte na přihlašovací nebo SSO obrazovce, procházení nasbírá jen přihlašovací stránky. I když funguje, crawler nevidí hierarchii stránek a při každé aktualizaci musí načíst všechny stránky znovu.

Zbytek kroku 1 popisuje cestu přes procházení. Pokud jste použili konektor, pokračujte krokem 2.

Krok 1: Přidejte Confluence jako zdroj

Confluence je jednostránková aplikace (SPA): obsah načítá přes JavaScript až poté, co se vykreslí kostra stránky. Běžné prohledávače tak dostanou prázdné stránky. ChatbotIQ si s tím poradí, jen je potřeba zvolit správná nastavení.

Přejděte na Znalostní báze → “Přidat zdroj” → Webová stránka.
Zadejte URL své Confluence (např. https://yourcompany.atlassian.net/wiki/spaces/DOCS).
U Režimu objevování zvolte Crawlování odkazů. Sitemapy Confluence bývají neúplné, takže sledování odkazů je spolehlivější.
U Režimu konfigurace zvolte Manuální.
Rozbalte Pokročilé možnosti a v sekci Preset webu zvolte Confluence / Wiki.

Co za vás preset nastaví

Nastavení	Hodnota	Proč
Režim čtečky	Zapnuto	Odstraní těžké UI prvky Confluence (postranní panel, drobečkovou navigaci, komentáře).
Souběžnost	2	Confluence agresivně omezuje rychlost. Vyšší souběžnost spustí chyby 429.
Čekací doba na obsah stránky	3 sekundy	Confluence načítá obsah asynchronními voláními API. Potřebuje čas na vykreslení.
Max. hloubka	10	Pro většinu prostorů dostatečné.

Co po jeho použití doladit

Nastavení	Doporučená hodnota	Proč
Selektor oblasti obsahu	`#main-content`	Cílí přímo na oblast s obsahem článku. Preset ho nechává prázdný.
Max. hloubka	15-20	Zvyšte, pokud je vaše wiki hluboce zanořená.
Max. stránek	Začněte s 200	Nejprve otestujte na části obsahu, pak zvyšte.

Klikněte na Spustit objevování, projděte stránky a pak klikněte na Spustit crawlování.

Počítejte s pomalejším procházením. Při souběžnosti 2 zvládne Confluence zhruba 2-5 stránek za minutu, takže wiki s 500 stránkami zabere kolem 2-3 hodin. To je v pořádku: nízká souběžnost vás chrání před tím, aby vás Confluence zablokovalo. Procházení běží na pozadí, stránku můžete zavřít.

Krok 2: Přidejte doplňkové PDF (volitelné)

Pokud má tým dokumenty i mimo Confluence (runbooky, směrnice) nebo pokud části wiki kvůli přihlášení nejde projít, přidejte je jako PDF zdroje. Postup viz Přidejte PDF a Q&A zdroje.

Krok 3: Vytvořte interního bota

Přejděte na Boti → “Vytvořit bota”.
Název: “Wiki Assistant” nebo “Team Knowledge Bot”.
Zdroje: Vyberte svůj Confluence zdroj a případné PDF zdroje.
Model: GPT-5 Mini se pro interní Q&A osvědčí. Pokud je dokumentace technická a plná nuancí, zvažte kvůli lepšímu uvažování GPT-5.2 nebo Sonnet 5.5.
Osobnost: Tady je šablona pro interní boty:

You are a knowledgeable assistant for the [Company] team. You help team members find information from our internal wiki and documentation.

Guidelines:
- Be concise and direct - team members want quick answers
- If the information might be outdated, mention when the source was last updated
- For sensitive topics (HR, legal, finance), remind the user to verify with the relevant team

Opírání o zdroje a citace jsou vestavěné, osobnost o ně nemusí žádat; určuje tón a zaměření.

Klikněte na Vytvořit.

Krok 4: Nakonfigurujte pro interní použití

Otevřete nastavení bota:

Soukromí: nechte ho soukromé

Nastavte Soukromí na Private. Bota tak mohou používat jen členové pracovního prostoru a žádný kód widgetu není potřeba, tým k němu přistupuje přes Přehled ChatbotIQ.

Případně zvolte Authenticated, pokud k němu má mít přístup jakýkoli přihlášený uživatel ChatbotIQ, nebo Public s Povolenými doménami nastavenými na vaši intranetovou doménu.

Citace zdrojů: základ důvěry

Nechte Zobrazit citace zdrojů zapnuté. Členové týmu si potřebují informaci ověřit a otevřít si celou stránku Confluence kvůli kontextu.

Obecné znalosti: zvažte zapnutí

Pokud chcete, aby bot doplňoval odpovědi z wiki o obecná vysvětlení, přepněte Povolit obecné znalosti na zapnuto. Když se třeba někdo zeptá “Co je Kubernetes?” a vaše wiki předchozí znalosti předpokládá, režim obecných znalostí doplní chybějící kontext.

Krok 5: Připojte se přes MCP (pro vývojáře)

Pokud váš tým používá vývojářské AI asistenty (Claude Desktop, Cursor, Windsurf), můžete je k znalostnímu botovi připojit přes MCP.

MCP vyžaduje placený plán. V bezplatném plánu se místo nastavení na záložce MCP zobrazí výzva k upgradu.

Otevřete bota, přejděte do Playgroundu a na Nasazení > AI asistenti.
Klikněte na S API klíčem. Je tu i volba Veřejné (bez auth), ale ta umožní dotazovat vaši znalostní bázi komukoli, kdo zná URL, takže se pro interní dokumentaci nehodí.
API klíč si hned zkopírujte, zobrazí se jen jednou. Později ho můžete nahradit tlačítkem Obnovit klíč.
Zkopírujte MCP Endpoint URL a v sekci Konfigurace klienta vyberte svého klienta.
V Claude Desktop: Settings → Connectors → klikněte na ”+” → zadejte název a URL, pak rozbalte Advanced settings a přidejte hlavičku Authorization se svým API klíčem.

Vývojáři se teď můžou svého asistenta ptát na interní dokumentaci, aniž by museli opustit IDE.

Krok 6: Otestujte se skutečnými otázkami

Vyzkoušejte otázky, které váš tým opravdu klade:

“Jak nastavím vývojové prostředí?”
“Jaký je postup při žádosti o dovolenou?”
“Kde najdu architektonický diagram fakturační služby?”
“Jaké jsou kroky runbooku při failoveru databáze?”

U každé odpovědi mrkněte do panelu RAG Debug:

Vyhledávají se správné stránky Confluence?
Je skóre relevance vysoké?
Je obsah čistý (bez textu navigace nebo postranního panelu)?

Pokud obsah vypadá zašuměně: Upravte Selektor oblasti obsahu. Když váš motiv Confluence používá jiné značkování, zkuste místo #main-content selektor article nebo .wiki-content.

Krok 7: Nasaďte pro svůj tým

Pozvěte členy týmu, přejděte na Tým a pozvěte kolegy. Přidělte jim roli Člen nebo Prohlížeč.
Sdílejte odkaz, pošlete týmu URL Přehledu ChatbotIQ.
Nastavte očekávání, dejte týmu vědět, co bot umí a co ne. Na hledání informací je skvělý, ale je jen tak dobrý jako obsah ve vaší wiki.

Udržujte ho aktuální

Obsah Confluence se mění často. Zdroj obnovujte jednou týdně a po větších úpravách wiki. Strategie obnovení viz Udržujte obsah aktuální.

Související

Nakonfigurujte procházení pro váš web - všechny postupy procházení
Připojte se přes MCP - detailní průvodce nastavením MCP
Udržujte obsah aktuální - strategie obnovení