Il copilota permette all'assistente IA della tua piattaforma di fare qualcosa in più che rispondere a testo: può **portare la persona su una schermata, evidenziarle dove si trova ogni cosa e, se tu lo consenti, compilare e premere pulsanti al posto suo** — sempre in bella vista, sempre con la sua sessione, sempre con la sua conferma prima di salvare qualcosa. Si basa su tre elementi: - **Il cervello** è l'agente IA del tenant, nel backend della Piattaforma. Decide *cosa* fare, ma non agisce mai direttamente contro il tuo sito: propone solo un piano. - **Le mani** sono l'SDK del copilota: una libreria senza IA e senza rete propria che installi accanto al tuo widget di chat. Non decide nulla — esegue in bella vista il piano proposto dal cervello, con il proprio dialogo di conferma. - **Il manifesto** è un JSON che scrivi tu: il catalogo chiuso di schermate, campi e pulsanti del tuo sito che il copilota può arrivare a usare. Se qualcosa non è nel manifesto, non esiste per l'assistente — non inventa mai una schermata né un pulsante. ``` flowchart LR subgraph Backend["Backend della Piattaforma"] Agente["Agente del tenant(il cervello)"] end subgraph Tuweb["Il tuo sito"] Widget["Il tuo widget di chat"] SDK["SDK del copilota(le mani, senza rete propria)"] DOM["I tuoi moduli epulsanti reali"] end Manifiesto["Il tuo manifesto v1(schermate e ancore)"] Agente -- "1. piano convalidato" --> Widget Widget -- "2. postMessage" --> SDK SDK -- "3. naviga / evidenzia / compila / preme" --> DOM SDK -. "dichiarato contro" .-> Manifiesto DOM -- "4. risultato reale" --> Widget Widget -- "5. risultato" --> Agente ``` Niente di tutto ciò accade se tu non lo attivi esplicitamente: avere il widget sul tuo sito **non** dà il copilota. Servono le tre cose insieme — (1) il copilota attivato per quel canale sulla Piattaforma, (2) l'SDK installato sul tuo sito con il suo manifesto e (3) quel manifesto approvato — e se manca anche solo una, il widget si comporta esattamente come una chat normale. > **Nota — L'SDK non parla mai con nessun server** > > L'SDK del copilota non fa nessuna chiamata di rete, propria o altrui — tutto ciò che fa è leggere il tuo manifesto, ascoltare messaggi `postMessage` dal tuo stesso widget (con l'origine verificata) e toccare il DOM della tua pagina. La conversazione con il backend della Piattaforma passa sempre attraverso il tuo widget, mai direttamente attraverso l'SDK.