# Instantanee

## Prezentare generală

Instantaneele vă permit să împachetați cei mai buni agenți AI — împreună cu tot ce știu și fiecare instrument pe care îl folosesc — într-un șablon reutilizabil și să instalați acel șablon pe oricare dintre subconturile dvs. cu un singur clic.

Perfecționează-ți configurarea o singură dată în contul tău, captureaz-o sub formă de snapshot, iar fiecare client nou va începe de la acea configurare testată, în loc de o pagină goală. De asemenea, poți partaja un snapshot printr-un link, astfel încât oricine are un cont să îl poată instala.

::: walkthrough snapshots
:::

Un instantaneu include, pentru fiecare agent:

- Configurația completă a agentului — instrucțiuni, playbook, personalitate, setări de comportament și răspuns, ore de activitate.
- **Cunoștințe** (opțional): întrebările frecvente ale agentului și sursele bazei de cunoștințe, inclusiv fișierele încărcate.
- **Instrumente** (opțional): funcțiile personalizate ale agentului și serverele MCP conectate.
- **Biblioteca media** (opțional): imaginile, videoclipurile și documentele pe care agentul le poate trimite, împreună cu instrucțiunile de trimitere a acestora.

Instantaneele sunt **înghețate la momentul capturii**. Dacă continuați să editați agentul ulterior, instantaneul nu se modifică — capturați unul nou atunci când doriți un șablon actualizat.

> **Conturi de agenție în noul spațiu de lucru pentru Agenți.** Instantaneele (snapshots) există pentru a distribui configurările agenților de la o agenție către subconturile sale, astfel încât pagina apare odată ce contul tău de agenție rulează în noul spațiu de lucru pentru Agenți (conturile sunt mutate automat — nu trebuie să faci nimic). Subconturile pot primi un instantaneu odată ce sunt și ele în spațiul de lucru pentru Agenți; selectorul de aplicare arată care dintre ele sunt pregătite. Orice client **nou** pe care îl creezi odată ce agenția ta se află în spațiul de lucru începe automat acolo, deci este gata să primească un instantaneu imediat — fără așteptare și fără a fi nevoie să activezi ceva.

---

## Unde găsiți instantaneele

Faceți clic pe **Instantanee** în bara laterală principală — se află chiar sub **Subconturi**, aproape de partea de jos a meniului.

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-empty.png" alt="Pagina Snapshots înainte de existența oricărui snapshot, cu butonul New snapshot și explicația stării goale"><figcaption><p>Pagina Snapshots. Înainte de prima captură, starea goală explică conceptul și oferă opțiunea <strong>Create your first snapshot</strong>.</p></figcaption></figure>
:::

---

## Capturarea unui instantaneu

1. Deschide **Instantanee** (Snapshots) și dă clic pe **Instantaneu nou**.
2. Dă-i un nume ușor de recunoscut — de ex. „Kit de pornire pentru imobiliare”.
3. Bifează agenții pe care dorești să îi incluzi. Poți grupa mai mulți agenți într-un singur instantaneu.
4. Alege ce dorești să incluzi:
   - **Include cunoștințe** — întrebări frecvente și surse ale bazei de cunoștințe (împreună cu fișierele lor).
   - **Include instrumente** — funcții personalizate și servere MCP.
   - **Include biblioteca media** — imaginile, videoclipurile și documentele pe care agentul le poate trimite.

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-create.png" alt="Fereastra New snapshot cu un nume completat, doi agenți bifați și comutatoarele Include knowledge și Include tools activate"><figcaption><p>Fereastra New snapshot: denumește-l, bifează agenții și alege dacă cunoștințele și instrumentele sunt incluse. Agenții sunt înghețați exact așa cum sunt în acest moment.</p></figcaption></figure>
:::

5. Faceți clic pe **Capture snapshot**. Capturarea poate dura puțin dacă este inclusă o cantitate mare de cunoștințe.

Noul snapshot apare în listă cu un rezumat al conținutului său:

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-list.png" alt="Lista Snapshots care arată rândul snapshot-ului capturat cu agenții săi, rezumatul conținutului, ora creării și acțiunile Apply, rename și delete"><figcaption><p>Fiecare rând arată agenții incluși, un rezumat al conținutului și acțiunile: steaua <strong>New clients</strong> (vezi mai jos), <strong>Apply</strong>, redenumire (creion) și ștergere (coș de gunoi).</p></figcaption></figure>
:::

---

## Aplicarea unui instantaneu

1. Dă clic pe **Aplică** (Apply) în dreptul unui snapshot.
2. Bifează conturile în care dorești să îl instalezi — oricare dintre sub-conturile tale sau propriul tău cont de agenție (care îți oferă o copie nouă a tot ceea ce conține snapshot-ul).

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-apply.png" alt="Fereastra de aplicare a snapshot-ului cu lista 'Instalează în' care arată contul de agenție și un cont de client bifate, comutatorul 'Omite conturile care au deja acest snapshot' activat și butonul 'Aplică la 2 conturi'"><figcaption><p>Fereastra de aplicare. Bifează unul sau mai multe conturi — și reține mementoul: agenții instalați pornesc în modul pauză, iar calendarele/OAuth trebuie reconectate pe contul țintă.</p></figcaption></figure>
:::

3. Dă clic pe **Aplică la N conturi**.

O copie nouă a fiecărui agent din instantaneu — plus cunoștințele și instrumentele sale — este creată în contul țintă. Aplicarea aceluiași instantaneu de două ori creează o a doua copie; nimic nu este suprascris.

### Agenții instalați pornesc în modul pauză

Agenții ajung în contul țintă **opriți**, în mod intenționat: câteva aspecte sunt specifice contului și trebuie configurate pe țintă înainte ca agentul să devină activ:

- **Canale** — conectați propriile canale WhatsApp / Instagram / altele ale contului țintă și direcționați-le către noul agent.
- **Calendar și rezervări** — dacă agentul original făcea programări, reconectați un calendar în contul țintă și reactivați rezervările.
- **Integrări conectate care utilizează OAuth** (de exemplu, un server MCP pe care l-ați autorizat cu un buton „Conectare”) — din motive de securitate, aceste conexiuni nu sunt niciodată copiate, așa că contul țintă își autorizează propriile conexiuni. Instrumentele care utilizează o cheie API simplă continuă să funcționeze imediat.

După ce canalele sunt conectate, activați agentul din pagina **Agenți AI** a contului țintă.

### Aplicarea la mai mulți clienți simultan

Lista **Instalează în** îți permite să bifezi câte conturi dorești. Folosește **Selectează toate sub-conturile** pentru a re-configura întreaga bază de clienți dintr-o singură mișcare, apoi dă clic pe **Aplică la N conturi**. Fiecare cont este procesat pe rând, iar fereastra afișează rezultatul pentru fiecare — instalat, omis sau eșuat cu motivul aferent — astfel încât un cont care nu a putut fi configurat să nu îi oprească pe celelalte.

**Omite conturile care au deja acest snapshot** este activat implicit: un cont care a primit deja exact acest snapshot este omis în loc să primească o a doua copie. Dezactivează această opțiune dacă dorești în mod deliberat o altă copie. Copiile instalate înainte de septembrie 2026 nu sunt recunoscute de această verificare, deci conturile configurate înainte de acea dată sunt tratate ca fiind noi.

---

## Instalarea automată a unui snapshot pe fiecare client nou

Dacă pornești întotdeauna clienții de la aceeași configurație, nu trebuie să aplici snapshot-ul manual de fiecare dată. Marchează un snapshot ca **implicit** (default) și fiecare cont de client nou pe care îl creezi va veni cu acesta deja instalat.

1. Deschide **Snapshots**.
2. Dă clic pe steluța din coloana **New clients** din dreptul snapshot-ului dorit.

Rândul marcat cu steluță afișează o insignă **Default**. Doar un singur snapshot poate fi implicit — marcarea altuia îl va muta pe acesta. Dă clic din nou pe steluță pentru a o dezactiva, iar conturile noi vor fi create din nou goale.

Acest lucru se aplică pentru orice metodă de creare a unui cont de client:

- Îl creezi tu însuți pe pagina **Sub Accounts**.
- Integrarea ta îl creează prin API.
- Un client cumpără prin propriul tău link de checkout și contul său este creat automat.

Această ultimă variantă reprezintă scopul funcționalității: un client poate plăti pe site-ul tău și poate ajunge în tabloul de bord personalizat cu agentul, baza de cunoștințe, instrumentele și conținutul media deja prezente, fără ca tu să faci nimic.

Câteva lucruri care merită știute:

- Agenții instalați **pornesc în pauză**, exact ca în cazul aplicării manuale — conectezi mai întâi canalele clientului, apoi pornești agentul.
- Instalarea rulează imediat după crearea contului. Dacă nu se poate finaliza din orice motiv, contul clientului este totuși creat și utilizabil — acesta va fi pur și simplu gol, iar tu poți aplica snapshot-ul manual.
- Ștergerea snapshot-ului marcat cu steluță elimină automat setarea implicită.

---

## Partajarea unui snapshot printr-un link

Poți oferi un snapshot oricui are un cont pe platformă — o agenție parteneră, un client care își gestionează propriul cont sau comunității — fără ca aceștia să fie unul dintre sub-conturile tale. Nimic specific contului tău nu este transferat odată cu acesta și poți opri partajarea în orice moment.

1. Dă clic pe **Partajează** (Share) în dreptul unui snapshot.
2. Alege cine îl poate instala:
   - **Oricine are linkul**.
   - **Doar membrii Champions Circle** — linkul funcționează doar pentru conturile care sunt membre ale comunității.
3. Dă clic pe **Creează link** și copiază-l.

Înainte de a trimite linkul, citește lista de verificare **Înainte de a partaja** din aceeași fereastră. Aceasta enumeră:

- **Câmpurile de completat** care îi vor fi solicitate celui care instalează (vezi mai jos).
- **Funcții personalizate de revizuit** — adresa web a fiecărei funcții este afișată, deoarece indică spre sistemele tale. Orice valori de antet trimise de funcție (chei API, tokenuri) sunt șterse în copia instalată; numele antetelor rămân, astfel încât cel care instalează să știe ce trebuie să completeze. Cel care instalează vede aceeași listă și este instruit să revizuiască acele funcții înainte de a activa agentul.
- **Servere MCP care au nevoie din nou de cheia lor** — cheile API pentru serverele tale MCP conectate nu sunt niciodată incluse într-o instalare partajată. Acestea apar dezactivate în contul celui care instalează, iar acesta își va introduce propria cheie.

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-share.png" alt="Fereastra de partajare a acestui snapshot cu linkul de instalare și butonul Copiază, opțiunea 'Cine poate instala' setată pe 'Oricine are linkul', lista de verificare 'Înainte de a partaja' și acțiunile 'Link nou' și 'Oprește partajarea'"><figcaption><p>Fereastra de partajare după <strong>Creează link</strong>: copiază linkul, alege cine îl poate instala, citește lista de verificare și folosește <strong>Link nou</strong> sau <strong>Oprește partajarea</strong> atunci când trebuie să restricționezi accesul.</p></figcaption></figure>
:::

Rândul arată de câte ori a fost instalat snapshot-ul. **Link nou** îți oferă un link proaspăt și face ca cel vechi să nu mai funcționeze; **Oprește partajarea** dezactivează complet linkul. Ambele acțiuni lasă intactă fiecare copie care a fost deja instalată.

### Câmpuri de completat

Scrie `{{company_name}}`, `{{support_email}}`, `{{website}}`, `{{booking_link}}` sau orice alt `{{word}}` în instrucțiunile agentului, în secțiunea Întrebări frecvente sau în descrierile media, iar acesta devine un câmp pe care instalatorul îl completează înainte de instalare. Valorile introduse de instalator înlocuiesc câmpurile peste tot în text; snapshot-ul tău original rămâne neatins.

`{{first_name}}` și `{{personal_context}}` sunt variabilele proprii de mesaje ale AI-ului, așa că acestea sunt lăsate intacte și nu sunt transformate niciodată în câmpuri de completat.

---

## Instalarea unui snapshot partajat cu tine

Deschide linkul care ți-a fost trimis în timp ce ești conectat (sau conectează-te când ți se solicită — vei fi redirecționat înapoi la pagina de instalare ulterior). Vei vedea numele snapshot-ului, cine l-a partajat, agenții pe care îi conține și ce se află în interior, apoi:

::: master-only
<figure><img src="../.gitbook/assets/v2-snapshots-install.png" alt="Pagina de instalare pentru un snapshot partajat care arată numele snapshot-ului, cine l-a partajat, cei doi agenți din interior, selectorul de instalare cu contul instalatorului selectat și butonul de Instalare"><figcaption><p>Pagina de instalare. Vezi ce conține și cine a partajat-o, alegi unde să fie instalată și dai clic pe <strong>Instalare</strong>.</p></figcaption></figure>
:::

1. Completează orice câmpuri pe care autorul le-a lăsat pentru tine, cum ar fi numele companiei sau site-ul tău web. Toate sunt opționale.
2. Alege unde să îl instalezi — în propriul tău cont sau în unul dintre sub-conturile tale, dacă administrezi o agenție.
3. Dă clic pe **Instalare**.

Agenții sunt copiați în contul pe care l-ai ales și **pornesc în stare suspendată**, exact ca un snapshot aplicat din pagina Snapshot-uri. Înainte de a-i activa:

- Conectează-ți propriile canale și direcționează-le către noii agenți.
- Revizuiește orice funcții personalizate listate pe ecranul de confirmare — acestea apelează adresele web ale autorului.
- Introdu propria cheie pe orice server MCP listat acolo, apoi activează-l.
- Reconectează un calendar dacă agentul programează întâlniri.

Instalarea contează în limita de agenți a contului tău, la fel ca orice alt agent pe care îl creezi.

---

## Gestionarea instantaneelor (Snapshots)

- **Redenumire** — pictograma creion de pe un rând.
- **Ștergere** — elimină instantaneul și fișierele stocate ale acestuia. Conturile pe care l-ați aplicat nu sunt afectate: tot ceea ce a fost instalat rămâne instalat.

---

## Ce nu este inclus

- Conexiunile canalelor și numerele de telefon (întotdeauna specifice contului).
- Calendarele și conexiunile pentru programări.
- Autentificările OAuth pentru integrările conectate.
- Contactele, chaturile și istoricul conversațiilor — snapshot-urile transferă *configurarea*, niciodată datele clienților.
- Șabloanele de mesaje WhatsApp (acestea sunt aprobate per cont și trebuie recreate pe destinație).
- Cheile API ale serverelor MCP și valorile antet ale funcțiilor personalizate, atunci când un snapshot este instalat dintr-un link de partajare (în cadrul propriei agenții, acestea sunt copiate).

## Legate

- [Gestionarea sub-conturilor clienților](sub-accounts.md)
- [Agenți AI](../ai-agents/ai-agents.md)