Cos'è il copilota e come si collega

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.