Z nuly k funkčnímu agentovi nad vašimi daty za méně než hodinu. Provede vás typickým prvním dnem.

Než začnete

Budete potřebovat:

• StellarBase účet (managed EU cloud — k dispozici je trial) nebo self-hosted nasazení
• Aspoň jeden datový zdroj, který chcete připojit (složka v Google Drive, knihovna SharePoint, Postgres DB nebo sada PDF k nahrání)
• Určitou představu o prvním workflow, které chcete spustit (literární rešerše, kontrola smluv, revize politik — vyberte něco konkrétního)

Pokud jste ještě nezvolili režim nasazení, přečtěte si Přehled nasazení. Pro trial vás nejrychleji rozjede managed EU cloud.

Krok 1 — Vytvořte Base

Base je top-level kontejner. Má vlastní data, vlastní agenty, vlastní oprávnění. Pro první pilot vytvořte jeden Base věnovaný úkolu, který zkoušíte.

Dejte mu jasný název („Pilot: Revize smluv”, „Research — Surface Codes”, „Onkologický tumor board”) a nastavte jazykové preference odpovídající vašemu obsahu.

Krok 2 — Připojte datový zdroj

Otevřete Base, klikněte na „Add source” a vyberte konektor. UI vás provede OAuth nebo přihlašovacími údaji podle potřeby.

Časté první konektory:

• Google Drive / SharePoint — jedna složka stačí. Nesnažte se naindexovat všechno první den.
• Upload — přetáhněte složku PDF nebo Word dokumentů přímo do UI
• Postgres / MySQL — namiřte na konkrétní tabulku nebo view, pokud máte strukturovaná data

Ingest je asynchronní. Pár stovek dokumentů typicky doběhne za pár minut. Pár tisíc může trvat až hodinu. Postup je vidět ve Base.

Viz Datové zdroje pro kompletní katalog konektorů.

Krok 3 — Prozkoumejte přes chat

Jakmile je první dávka dokumentů naindexovaná, otevřete Chat a zeptejte se na něco konkrétního. Ne „shrň databázi” — to je moc široké. Zkuste:

• „Najdi všechny smlouvy zmiňující change-of-control z roku 2024”
• „Které z těchto publikací rozebírají [konkrétní techniku]?”
• „Shrň tři nejcitovanější dokumenty o [tématu]”

Každá odpověď cituje zdroje. Klikněte na citace pro ověření. Tohle je nejrychlejší způsob, jak zjistit, jestli indexování zafungovalo a korpus pokrývá to, co potřebujete.

Krok 4 — Vytvořte prvního agenta

Magický okamžik. Agenti kódují váš playbook. Klikněte na „Create agent” a vyplňte:

• Name — popisné („MSA Reviewer”, „Literature Screener”)
• Role / description — jedna věta
• System prompt — sem patří vaše doménová znalost. Začněte jednoduše: „You are a [role]. For every input, do [task]. Flag [criteria]. Always cite the source document + page.”
• Knowledge scope — které kolekce může agent číst
• Tools — začněte se search + OCR; další přidávejte podle potřeby
• Output schema — volitelné, ale doporučené pro navazující zpracování

Otestujte ho na 3–5 dokumentech, které dobře znáte. Dolaďte prompt podle toho, co dostává špatně. Tahle iterativní smyčka obvykle zabere 15–30 minut na agenta, než je production-ready.

Viz Agents pro detailní návod ke psaní promptů.

Krok 5 — Sestavte workflow (zatím volitelné)

Pro opakované úkoly proměňte agenta na workflow. Vizuální editor vám umožňuje řetězit uzly:

• Vstup — nové dokumenty ve složce, webhook, plán
• Zpracování — StellarOCR, extrakce entit, anonymizace
• Volání agenta
• Výstup — řádek do CSV, insert do databáze, e-mail, Slack zpráva

První den to nepotřebujete. První den je o ověření, že agent funguje. Třetí nebo pátý den se workflows začnou vyplácet.

Viz Workflows.

Krok 6 — Pozvěte kolegy

Přidejte spolupracovníky do Base s odpovídající rolí (editor pro lidi, kteří konfigurují agenty, reviewer pro lidi, kteří validují výstupy, viewer pro lidi, kteří jen konzumují). Každý má vlastní chat thread, vidí sdílené agenty a workflows a přispívá do sdíleného audit logu.

Viz Collaboration.

Časté úskalí prvního dne

Snaha naindexovat všechno najednou

Začněte se zaměřeným korpusem — jedna složka, jedna kauza, jeden projekt. Z 200 relevantních dokumentů dostanete lepší výsledky než z 50 000 promíchaných. Rozšiřte později.

Začínat s moc širokým promptem

Agenti fungují nejlíp na úzkých, dobře definovaných úkolech. „Zreviduj tuhle smlouvu” je moc široké; „Identifikuj change-of-control klauzule a zkontroluj proti playbooku naší kanceláře” má správnou velikost.

Vynechání citací

Vždycky agentovi řekněte, ať cituje. Pár citací ručně zkontrolujte. Důvěra se staví na ověřitelnosti.

Předpoklad, že prompt je hotový napoprvé

Není. Počítejte s 3–5 iteracemi, než agent spolehlivě dělá, co chcete. To je normální — a je to mnohem rychlejší než trénovat klasifikátor od nuly.

Co číst dál

• Klíčové koncepty — mentální model (pokud jste ho přeskočili)
• Přehled platformy — kompletní mapa funkcí
• Agents — psaní promptů
• Přehled bezpečnosti — až budete připraveni otevřít přístup týmu