Průvodce nastavením
Vytvořte admin účet pro znalosti, připojte Notion, Slack a Google Drive přes MCP, ověřte zdroje a nasaďte agenta. Předběžný přístup.
Na této stránce
Předběžný přístup / preview. Tento průvodce popisuje aktuální postup nastavení. Obrazovky a možnosti konektorů se mohou před obecnou dostupností změnit.
Tento průvodce vás provede od nuly k živému agentovi s oporou v datech: vytvoření admin účtu, připojení znalostí přes MCP konektory, ověření naindexovaného obsahu a nasazení agenta do webového widgetu, Slacku nebo přes API. Doplňuje referenci Agent API.
1. Vytvořte admin účet pro znalosti
Přejděte na admin.praktickai.app a zaregistrujte se pracovním e-mailem. V admin konzoli spravujete konektory, znalostní zdroje, API klíče a mantinely (guardrails). První workspace se vytvoří automaticky; kolegy pozvete v Nastavení → Členové.
Jako vlastníka workspace použijte sdílenou týmovou adresu (např. ai-admin@vasefirma.cz), aby přístup přežil personální změny.
2. Pochopte MCP konektory
MCP (Model Context Protocol) je otevřený standard pro propojení AI asistentů s externími nástroji a daty. Místo exportu souborů jednou autorizujete konektor a PraktickAI čte obsah živě, s respektem k uděleným oprávněním. Konektory pro znalosti jsou jen pro čtení: agent obsah indexuje a cituje, ale nikdy jej neupravuje.
| Konektor | Co čte | Autorizace | Rozsah k udělení |
|---|---|---|---|
| Notion | Vybrané stránky a databáze | OAuth | Čtení obsahu sdílených stránek |
| Slack | Vybrané veřejné kanály | OAuth (instalace bota) | Čtení zpráv ve zvolených kanálech |
| Google Drive | Vybrané složky a dokumenty | OAuth | Přístup jen pro čtení k vybraným souborům |
Udělte co nejužší rozsah. Nasdílejte jediný teamspace v Notionu, přidejte Slack bota jen do kanálů, které chcete indexovat, a vyberte konkrétní složky na Disku místo celého účtu.
3. Připojte Notion
V admin konzoli otevřete Konektory → Notion → Připojit a dokončete OAuth. Na souhlasné obrazovce Notionu vyberte jen stránky nebo databáze, které má agent číst. V konzoli se poté objeví jako dostupné zdroje.
Konektory → Notion → Připojit → (Notion OAuth) → vyberte stránky → Uložit4. Připojte Slack
Otevřete Konektory → Slack → Připojit a nainstalujte bota PraktickAI do workspace. Bota pozvěte do každého kanálu k indexaci příkazem `/invite @PraktickAI`. Čitelné jsou jen kanály, jejichž je bot členem.
/invite @PraktickAI # spusťte v každém kanálu k indexaci5. Připojte Google Drive
Otevřete Konektory → Google Drive → Připojit a autorizujte přes svůj Google účet. Ve výběru složek zvolte konkrétní složky nebo dokumenty — konektor žádá přístup jen pro čtení a soubory nikdy neupravuje.
6. Přidejte a ověřte zdroje
Pro každý autorizovaný konektor přidejte konkrétní zdroj jako znalostní zdroj v Znalosti → Přidat zdroj (nebo přes `POST /v1/agent/knowledge/sources/`). Každý nový zdroj začíná ve stavu `syncing` a po naindexování přejde na `synced`.
curl https://api.praktickai.app/v1/agent/knowledge/sources/ \
-H "Authorization: Bearer pk_live_xxxxxxxxxxxxxxxx"Ověřte, že zdroj ukazuje `status: synced` a nenulový počet `documents`, pak položte testovací dotaz v Znalosti → Playground a potvrďte, že odpověď cituje očekávaný zdroj.
Pokud zdroj zůstává prázdný, ověřte, že bot/OAuth oprávnění opravdu pokrývá daný obsah — nejčastější problém je, že Slack bot není pozván do kanálu nebo stránka v Notionu není sdílená s integrací.
7. Nasaďte agenta
Jakmile jsou zdroje synchronizované, nasaďte agenta jedním či více kanály:
| Kanál | Jak | Vhodné pro |
|---|---|---|
| Webový widget | Zkopírujte snippet z Nasazení → Webový widget na svůj web | Podpora zákazníků na vašem webu |
| Slack | Zapněte Nasazení → Slack a kolegové mohou agenta @-zmínit | Interní Q&A nad firemními znalostmi |
| API | Volejte `POST /v1/agent/messages/` z backendu | Vlastní aplikace a stávající chatová rozhraní |
<script
src="https://admin.praktickai.app/widget.js"
data-agent-key="pub_xxxxxxxxxxxx"
async
></script>Webový widget používá veřejný klíč (`pub_...`), ne váš tajný API klíč. Je bezpečné jej vložit do prohlížeče a umožňuje pouze odesílání zpráv vašemu agentovi.
8. Kontrolujte odpovědi a nastavte mantinely
V sekci Guardrails řídíte, jak se agent chová, když si není jistý. Doporučené výchozí hodnoty pro nové nasazení:
- Jen s oporou v datech: odmítnout odpověď, když neodpovídá žádný zdroj, místo hádání.
- Záložní zpráva: přátelské "Předám to kolegovi", když je grounded false.
- Předání člověku: e-mailové odpovědi s nízkou jistotou směrovat do návrhu (viz práh autosend v Email API).
- Log kontrol: první týdny procházejte log odpovědí a palcem dolů označte cokoli mimo, což ladí vyhledávání.
Začněte konzervativně — odpovědi jen s oporou v datech plus vysoký práh automatického odeslání e-mailů — a nastavení uvolňujte, jak log odpovědí ukáže, že je agent spolehlivý.
A je to — váš agent nyní odpovídá z vašich připojených znalostí. Pokračujte referencí Agent API pro vlastní řešení, nebo referencí Email API pro automatizaci odpovědí ze schránky.