Trezor

API kľúče, heslá a ďalšie prihlasovacie údaje ukladajte do osobného Trezoru namiesto vkladania do chatu. Chetty hodnoty uchováva šifrovane, znovu ich nezobrazuje a agentovi poskytuje iba názvy a popisy položiek. Agent zapíše {{vault:NAME}}; hodnota sa doplní až pri spustení nástroja a presné hodnoty vo výstupe nástrojov sa skryjú ako «vault:NAME».

Trezor chráni pred nechceným prezradením, nie pred agentom, ktorý sa údaje zámerne snaží odoslať inam. Je osobný, nie zdieľaný pre Projekt alebo tím. Samotný nástroj Vault vypisuje iba názvy a popisy.

Pridanie položky

1. Otvorte Účet → Trezor, medzi Zabezpečenie a API tokeny.
2. Na karte Vaše položky zvoľte Pridať položku.
3. Zadajte názov, napríklad API_KEY. Používajte veľké písmená A–Z, číslice a podčiarkovníky, začnite písmenom a neprekročte 64 znakov. Malé písmená sa pri písaní samy zmenia na veľké.
4. Pridajte popis s dĺžkou 1–500 znakov, ktorý vysvetlí, na čo má agent položku používať. Tajnú hodnotu nevkladajte do názvu ani popisu.
5. Zadajte hodnotu do poľa pre heslo. Pre kľúče na viacerých riadkoch prepnite na viacriadkové zadávanie. Hodnota musí mať aspoň štyri znaky a najviac 64 KiB textu v UTF-8; uloží sa presne tak, ako ju zadáte.
6. Položku uložte. Karta Vaše položky ju ukáže zbalenú: názov s časom, keď ju naposledy použilo volanie nástroja, a časom poslednej zmeny, pod nimi popis, nikdy hodnotu.

Môžete tiež požiadať asistenta o uloženie, zmenu alebo zmazanie položky, ak má oprávnenie používať API. Ak mu pošlete hodnotu na uloženie, prejde konverzáciou ešte pred uložením do Trezoru; uložením sa z predchádzajúcej konverzácie neodstráni. Ak chcete hodnotu udržať mimo chatu, zadajte ju do formulára Účet → Trezor. Chatbot účty trezor nemajú.

Ako požiadať agenta o použitie položky

Môžete napríklad napísať: „Použi API_KEY z môjho Trezoru na overenie požiadavky na ukážkovú službu.“

Agent zavolá nástroj Vault, ktorý vypíše položky ako NAME: popis, a do argumentu nástroja zapíše {{vault:API_KEY}}. Hodnotu nepotrebuje vidieť ani si ju pamätať. Jeho účet musí mať pridelený nástroj Vault aj oprávnenie používať nástroj, ktorý hodnotu prijme.

Neznámy názov zastaví volanie skôr, než sa čokoľvek spustí. Bez prideleného nástroja Chetty zástupný zápis odmietne namiesto toho, aby ho odoslal ako prihlasovací údaj. Žiadosti o schválenie aj uložené vzory oprávnení obsahujú iba zástupný zápis. Text uložený pre neskorší beh si zástupné zápisy ponechá: pamäť, zadania delegovaných úloh, prompty naplánovaných úloh a jednorazových prebudení, úlohy, skilly a pokyny pre hlasové hovory. Neskorší beh ich vyhodnotí až pri použití nástroja.

Úvodzovky v Bashi

Zástupné zápisy vkladajte do dvojitých úvodzoviek, nikdy do jednoduchých. Napríklad:

curl -H "Authorization: Bearer {{vault:API_KEY}}" https://api.example.com/status

Terminál odovzdá hodnotu ako premennú prostredia práve tomuto procesu, nie v argumentoch spúšťacieho príkazu. Samostatný zástupný zápis sa tiež rozvinie, ale dvojité úvodzovky udržia medzery a konce riadkov pohromade. V jednoduchých úvodzovkách sa nerozvinie. Toto pravidlo platí aj vtedy, keď Bash spúšťa PowerShell na spárovanom počítači s Windows.

Ak spárovaný počítač hlási LOCAL_CLIENT_OUTDATED, aktualizujte Chetty CLI na vydanie zodpovedajúce serveru.

Nahradenie alebo zmazanie položky

Pri každej položke sú vedľa názvu tlačidlá Upraviť (popis), Nahradiť (hodnotu) a Odstrániť. Pri nahradení sa otvorí pole pre heslo s rovnakou možnosťou viacriadkového zadávania; pôvodná hodnota sa nikdy neodhalí. Nahradenie alebo odstránenie sa prejaví hneď pri ďalšom volaní nástroja.

Po rozbalení položky uvidíte, koľko volaní nástrojov ju použilo v jednotlivých dňoch zvoleného obdobia, a pod grafom celkový počet. Obdobie je spoločné pre všetky položky. Každé volanie sa počíta raz za každú položku, ktorú použije, aj keď nástroj potom zlyhá. Odstránením položky sa zmaže aj záznam o jej použití.

Čí trezor sa použije

V zdieľanej konverzácii agent používa trezor človeka, na ktorého správu odpovedá. Vo vlastnom chate, naplánovaných úlohách a delegovaných podriadených agentoch používa trezor vlastníka (podriadený agent zachová účet zadávateľa). Odosielateľ z inej chatovacej platformy potrebuje prepojený ľudský účet. Konsolidácia pamäte prístup k trezoru nemá.

Obmedzenia

Chráni pred nehodami, nie pred agentom, ktorý hodnotu zámerne zakóduje, rozdelí alebo odošle inam. Obrázky sa nečistia. Súbory na disku si ponechajú to, čo do nich bolo zapísané; pri ich opätovnom čítaní sa výstup čistí. To isté platí pre text, ktorý agent uloží všeobecným nástrojom na zápis alebo priamym volaním API Chetty: zástupný zápis sa pred uložením nahradí skutočnou hodnotou. Naplánovaná úloha, ktorej prompt sa odošle priamo do API plánovača, preto ponesie hodnotu do každého ďalšieho spustenia. Naplánované úlohy nechajte agenta vytvárať bežným nástrojom na plánovanie, ktorý zástupný zápis zachová. Čo nástroj s hodnotou odošle alebo uloží (HTTP požiadavka, e-mail, záznam pluginu, napríklad komentár ku karte), opúšťa trezor; práve to je samotné použitie. V Bashi musí byť zástupný zápis v dvojitých úvodzovkách alebo stáť samostatne; v jednoduchých úvodzovkách sa nerozvinie. Živý koniec výstupu bežiaceho príkazu sa čistí pri každej aktualizácii. Hodnota, ktorú príkaz nedostal cez trezor (napríklad pri cat .env), sa môže zobraziť ako úryvok na orezanom okraji tohto posuvného okna; konečný výsledok a všetko, čo vidí model, sú celé a vyčistené. Hodnoty odovzdané cez trezor už zo streamu odstraňuje redakcia výstupu Sandboxu.