Spuštění kouzla: Příkaz /update – váš hlavní nástroj pro trénink znalostí a konfigurací

Nyní, když máte své know-how připraveno ve složce sources na Google Drive a případně jste si upravili nastavení v Transcription settings.gdoc, je čas dát vaší BuddyPro instanci pokyn, aby si všechny tyto informace "přečetla", zpracovala, uložila do své znalostní báze a také načetla vaše aktuální nastavení osobnosti a onboardingu.

10.1 Příkaz /update: co přesně dělá a kdy ho potřebujete?

V chatu s vaší BuddyPro instancí (v Telegramu) zadejte klíčový příkaz:

/update

Tento příkaz je centrálním bodem pro aktualizaci prakticky všeho, co definuje vašeho AI experta (kromě obsahu samotných expertních podrolí, na to je určen samostatný příkaz /updateRoles, viz kapitola 11). Na pozadí příkaz /update spustí následující komplexní sérii kroků:

1. Synchronizace se složkou sources na Google Drive:
   • BuddyPro pečlivě zkontroluje obsah vaší složky sources a všech jejích relevantních podsložek (sources/Files, sources/Texts, sources/URLs).
   • Identifikuje všechny nové soubory nebo URL, které jste přidali od posledního spuštění /update.
   • Rozpozná změněné existující Google Dokumenty (např. v sources/Texts nebo soubor URL SOURCES.gdoc ve složce sources/URLs).
   • Všimne si smazaných souborů nebo URL ze složky sources.
2. Zpracování nových nebo změněných znalostních zdrojů:
   • Pro všechny nové nebo upravené audio a video soubory (nahrané do sources/Files nebo přidané jako URL do sources/URLs/URL SOURCES.gdoc) provede jejich přepis na text (transkripci). Přitom plně respektuje vaše aktuální nastavení v souboru transcription_settings.gdoc (jazyk, klíčová slova, vylepšené přepisy).
   • Pro nové PDF, DOCX, TXT soubory (v sources/Files) a Google Dokumenty (v sources/Texts) extrahuje jejich kompletní textový obsah.
   • Pro nové nebo upravené URL odkazy v souboru sources/URLs/URL SOURCES.gdoc se pokusí stáhnout a extrahovat textový obsah daných webových stránek. U YouTube a Vimeo videí se pokusí získat textový přepis.
   • Výsledné čisté textové přepisy (transkripce) nebo extrahované texty těchto zdrojů uloží do příslušných podsložek transcriptions ve složce sources na vašem Google Drive (např. do sources/Files/transcriptions/NazevSouboru.gdoc nebo sources/URLs/transcriptions/nazev-url.gdoc).
     • Poznámka pro vaši kontrolu: Tyto transkripční soubory vám umožňují zkontrolovat, jak přesně bylo vaše know-how přepsáno a jaký textový základ bude AI používat. Standardně obsahují na začátku i metadata (stručný souhrn obsahu daného zdroje a návrh potenciálních expertních podrolí, které by z něj mohly vzniknout). Do těchto metadat nedoporučujeme zasahovat. Samotný text transkripce můžete v případě potřeby ručně na Google Drive upravit (např. opravit zásadní chyby v přepisu). Pokud tak učiníte, je nutné znovu spustit příkaz /update, aby se vaše manuální změny v transkripci promítly do znalostní báze AI.
3. Aktualizace interní vektorové databáze (znalostního "mozku" AI):
   • Veškerý nově zpracovaný nebo změněný textový obsah (po přepisu/extrakci) je inteligentně rozdělen na menší logické úseky ("chunks").
   • Každý tento úsek je převeden na vektorový embeding (komplexní matematickou reprezentaci jeho významu a kontextu).
   • Tyto vektory jsou přidány nebo aktualizovány ve vnitřní zabezpečené vektorové databázi vaší AI instance. Tato databáze je unikátní pro vašeho AI experta.
   • Pokud jste některé zdrojové soubory nebo URL ze sources smazali, odpovídající data a vektory jsou z vektorové databáze také bezpečně odstraněna. Váš AI expert tak "zapomene" informace, které již nemají být součástí jeho znalostí.
4. Aktualizace seznamu navrhovaných expertních podrolí:
   • Na základě kompletního, aktuálně zpracovaného obsahu vaší znalostní báze BuddyPro znovu analyzuje možná témata a specializace obsažené ve vašem know-how.
   • Seznam názvů těchto navrhovaných (nebo vámi již potvrzených a případně upravených) expertních podrolí aktualizuje v souboru ROLES/list_of_roles.gdoc na vašem Google Drive.
   • Důležité upozornění: Příkaz /update sám o sobě nevytváří ani nemění detailní obsah (definice) těchto rolí v jejich samostatných Google Dokumentech ve složce ROLES. To je úkolem až následného příkazu /updateRoles (viz kapitola 11). Příkaz /update pouze připravuje "půdu" a aktualizuje seznam návrhů názvů rolí.
5. Načtení aktuálních verzí klíčových konfiguračních souborů:
   • Příkaz /update také zajistí, že si vaše AI instance znovu načte a aplikuje aktuální obsah následujících konfiguračních Google Dokumentů z kořenové složky vašeho propojeného Google Drive:
     • 📄 system_prompt.gdoc (definice hlavní osobnosti, stylu komunikace a základních pravidel chování vaší AI)
     • 📄 onboarding.gdoc (nastavení uvítacích zpráv pro nové uživatele a automatických zpráv v průběhu konverzace)
     • 📄 transcription_settings.gdoc (nastavení parametrů pro přepis audio a video souborů)
   • To znamená, že pokud provedete jakoukoli, byť sebemenší, změnu v těchto třech klíčových konfiguračních souborech, musíte poté vždy spustit /update, aby se vaše změny projevily v chování a fungování vaší AI instance! Bez toho bude AI stále pracovat s předchozím nastavením.

10.2 Jak sledovat průběh zpracování /update a kdy je hotovo?

• Po zadání příkazu /update vám vaše BuddyPro instance v Telegramu obvykle potvrdí, že proces byl zahájen krátkou zprávou (např. Updating Buddy Pro...).
• Doba zpracování závisí na množství a typu nového nebo změněného know-how a konfiguračních souborů. Zpracování několika malých textových souborů může být hotové během pár sekund či minut. Přepisování hodin nových audio/video materiálů nebo zpracování velkého množství URL může trvat i déle (někdy i několik hodin, v závislosti na množství obsahu).
• Po úspěšném dokončení celého procesu by vám měla vaše BuddyPro instance poslat do Telegramu zprávu, například: Updating Buddy Pro Finished Successfully.
• Co dělat, když proces trvá příliš dlouho?
  1. Buďte trpěliví: Zejména pokud jste nahráli velké množství dat (např. mnoho videí, dlouhé audio nahrávky, desítky URL), dejte systému dostatek času na práci. U opravdu velkých objemů to může být až 5 hodin.
  2. Zkontrolujte Google Drive: Podívejte se do složek transcriptions v rámci sources (např. sources/Files/transcriptions nebo sources/URLs/transcriptions). Pokud tam postupně přibývají nové přepsané soubory (dokumenty .gdoc s přepisy), znamená to, že systém stále pracuje a zpracovává vaše know-how.
  3. Zeptejte se své BuddyPro instance: Pokud si nejste jisti, zda proces doběhl, můžete se zepta své BuddyPro isntance v jakém je váš update know-how stavu a zda stále probíhá.

10.3 Řešení běžných chyb a problémů při zpracování příkazem /update

Pokud BuddyPro během procesu /update narazí na problém s některým konkrétním souborem, URL, nebo s konfiguračními soubory, obvykle vás o tom informuje ve zprávě v Telegramu po (částečném nebo neúspěšném) dokončení a vypíše seznam problematických zdrojů nebo typ chyby.

• Nejčastější chyby a jejich řešení:
  • 📁 Chyba týkající se podsložek (např. Subfolders not allowed in sources/Files nebo podobná hláška pro Texts či URLs):
    • Příčina: Ve vaší složce sources/Files (nebo sources/Texts či sources/URLs) jste vytvořili nějaké vlastní podsložky. Platforma BuddyPro očekává, že všechny znalostní soubory budou umístěny přímo v těchto hlavních určených podsložkách (Files, Texts, URLs), nikoli v další, vámi vytvořené úrovni adresářů uvnitř nich.
    • Řešení: Otevřete příslušnou složku (sources/Files, sources/Texts nebo sources/URLs) na vašem Google Drive. Přesuňte všechny soubory z vašich vlastních podsložek o úroveň výše (tedy přímo do složky Files, Texts nebo URLs). Poté prázdné, vámi vytvořené podsložky smažte. Po této úpravě struktury spusťte příkaz /update znovu.
  • 🚫 Chyba: The user does not have sufficient permissions for this file (nebo jiná chyba týkající se přístupových práv k souboru):
    • Příčina: Nejčastěji k této chybě dochází, pokud jste omylem vytvořili nebo ručně nahráli nějaký soubor přímo do některé ze systémových podsložek transcriptions (např. sources/Files/transcriptions nebo sources/URLs/transcriptions). Tyto složky jsou určeny výhradně pro soubory generované automaticky platformou BuddyPro (tedy pro přepisy vašich znalostních zdrojů). Pokud tam vložíte soubor sami, BuddyPro pak logicky nemá oprávnění takový "cizí" soubor přepsat, smazat nebo s ním jinak manipulovat, protože vlastníkem souboru jste vy, nikoli systém BuddyPro.
    • Řešení: Pečlivě projděte si všechny podsložky transcriptions na vašem Google Drive (v sources/Files, sources/Texts i sources/URLs). Smažte jakékoli soubory, které jste tam vytvořili nebo nahráli vy ručně. Pamatujte – do těchto složek (transcriptions) nikdy nic sami nepřidávejte (s výjimkou velmi cílené a opatrné manuální úpravy již existujícího konkrétního přepisu, pokud víte, co děláte a proč – ale i to je lepší nedělat, pokud si nejste stoprocentně jistí). Po vyčištění těchto složek spusťte příkaz /update znovu.
  • ⚠️ Chyba při přepisu konkrétního audio, video souboru nebo URL:
    • Příčina: Může být způsobena různými faktory:
      • Soubor je příliš velký a serveru dojde operační paměť při jeho zpracování.
      • Nahrávka má extrémně špatnou kvalitu zvuku, což znemožňuje spolehlivý přepis.
      • Formát souboru není plně podporován nebo je poškozený.
      • URL adresa je dočasně nebo trvale nedostupná, nebo stránka za ní vyžaduje přihlášení.
      • Došlo k přechodnému technickému problému na straně externí AI přepisovací služby, kterou BuddyPro využívá.
      • U velmi dlouhých videí (např. nad cca 3 hodiny) může také docházet k problémům se stahováním ze zdrojové platformy (např. YouTube) nebo se zpracováním tak velkého objemu dat najednou.
    • Řešení:
      • Zkuste problematický soubor nahrát znovu (někdy pomůže, pokud šlo o dočasný výpadek).
      • U velkých video souborů zkuste nahrát verzi s nižší kvalitou obrazu (menší datový objem) nebo, pokud je to možné, extrahovat a nahrát pouze jeho audio stopu ve formátu MP3 (která je datově mnohem menší a pro AI stejně hodnotná, protože obrazovou informaci AI primárně nezpracovává).
      • U nedostupných URL ověřte jejich funkčnost v anonymním okně prohlížeče – musí být veřejně přístupné.
      • Pokud problém s konkrétním souborem/URL přetrvává i po opakovaných pokusech a ověření, kontaktujte podporu BuddyPro (support@buddy.fm) a ideálně jim poskytněte odkaz na problematický soubor/URL k analýze, aby mohli problém prověřit.
• Po jakékoli opravě problému na vaší straně vždy spusťte příkaz /update znovu, aby se změny projevily a systém se pokusil data znovu správně zpracovat.

10.4 "/update" je váš nejčastější parťák: pravidelně ho používejte!

Shrneme si to: příkaz /update musíte použít POKAŽDÉ, když uděláte jakoukoli z následujících významných změn ve vaší BuddyPro konfiguraci nebo znalostní bázi:

• ➕ Přidáte nové soubory (PDF, audio, video, textové dokumenty) nebo URL odkazy do příslušných podsložek ve složce sources na vašem Google Drive.
• ✏️ Upravíte obsah jakéhokoli existujícího souboru nebo Google Dokumentu ve složce sources (např. aktualizujete informace v PDF, přepíšete kapitolu v Google Dokumentu v sources/Texts, přidáte nové URL do URL SOURCES.gdoc).
• ❌ Smažete některé soubory nebo URL odkazy ze složky sources (aby AI přestala používat zastaralé nebo již nechtěné informace).
• ⚙️ Provedete sebemenší změnu v obsahu klíčových konfiguračních souborů system_prompt.gdoc, onboarding.gdoc, nebo transcription_settings.gdoc

Bez spuštění /update se vaše změny neprojeví v chování ani ve znalostech vaší AI instance! Je to jako když uložíte dokument na svém počítači, ale nezapnete synchronizaci s cloudem – ostatní (v tomto případě vaše AI) uvidí stále starou verzi a budou pracovat se zastaralými daty nebo nastavením.

10.5 Možnost přerušení dlouhotrvajícího procesu: Příkaz /stopUpdate

Pokud z nějakého velmi naléhavého důvodu potřebujete přerušit aktuálně probíhající proces /update (například jste si pozdě uvědomili, že jste omylem nahráli obrovské množství dat, které jste nechtěli zpracovávat, a chcete to co nejdříve zastavit), můžete použít příkaz:

/stopUpdate

Po použití /stopUpdate a nápravě situace (např. smazání nechtěných souborů) budete muset spustit /update znovu.

S tímto pochopením příkazu /update jste nyní vybaveni klíčovým nástrojem pro trénink a konfiguraci vašeho AI Experta. V další kapitole se podíváme na to, jak z vašeho zpracovaného know-how vytvořit specifické expertní "klobouky" – tedy expertní podrole – pomocí příkazu /updateRoles.

---

Často kladené otázky (FAQ) k tomuto kroku:

• Co se stane, když změním system_prompt.gdoc (nebo onboarding.gdoc / transcription_settings.gdoc) a nespustím /update? Vaše AI instance bude i nadále používat předchozí, starou verzi tohoto konfiguračního souboru, kterou měla načtenou. Vaše změny se neprojeví, dokud nespustíte /update.
• Musím po každé drobné úpravě jednoho souboru v sources spouštět /update? Ano, pokud chcete, aby se tato drobná úprava projevila ve znalostech AI. Příkaz /update je navržen tak, aby byl relativně efektivní a zpracoval pouze změněné nebo nové části.
• Co když omylem smažu přepis (transcription soubor) ze složky transcriptions místo původního souboru ze sources? Pokud smažete pouze přepisový soubor .gdoc ze složky transcriptions, ale původní zdrojový soubor (např. PDF, MP3) zůstane ve složce sources/Files (nebo URL v URL SOURCES.gdoc), pak při dalším spuštění /update systém detekuje, že zdrojový soubor stále existuje, ale jeho přepis chybí, a pokusí se ho znovu vytvořit. Pokud však chcete, aby AI dané know-how "zapomněla", musíte smazat přímo ten původní zdrojový soubor ze složky sources (např. sources/Files/moje_video.mp4) a poté spustit /update.
• Jaký je rozdíl mezi aktualizací seznamu rolí v ROLES/list_of_roles.gdoc a generováním obsahu rolí? Příkaz /update analyzuje vaše know-how a aktualizuje pouze seznam názvů navrhovaných expertních podrolí v souboru ROLES/list_of_roles.gdoc. Tento soubor slouží jako "jídelní lístek" dostupných specializací. Samotný detailní obsah (definici) každé role (což jsou samostatné, často několikastránkové Google Dokumenty ve složce ROLES) však příkaz /update nevytváří ani nemění. To je až úkolem příkazu /updateRoles, který na základě aktuálního seznamu a vašeho know-how detailně vygeneruje nebo aktualizuje obsah každé jednotlivé role.

---