> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/condivisione/publish-your-agent/embed-your-agent-on-a-website.md).

# Incorpora il tuo agente in un sito web

Incorporare un Agente consente agli utenti di interagire direttamente con esso all'interno del tuo sito web o della tua applicazione web senza lasciare la pagina.

Per la maggior parte dei siti web, l'approccio più semplice è partire da un layout di condivisione e utilizzare il codice di incorporamento generato da AIsuru.

### Ottieni il codice di incorporamento

Per ottenere il codice per un layout:

1. Apri il pannello di gestione dell'Agente;
2. Vai a **Condividimi**;
3. Crea un nuovo layout o aprine uno esistente;
4. Apri il pulsante nella sezione **Codice di incorporamento** del layout;
5. Copia il codice generato.

Se hai bisogno di aiuto per scegliere o configurare prima l'esperienza, consulta [Layout di condivisione.](/condivisione/sharing-layouts.md)

### Aggiungi l'Agente al tuo sito web

Dopo aver copiato il codice:

1. Apri l'editor, il CMS o il codice sorgente della pagina in cui desideri visualizzare l'Agente;
2. Incolla il codice generato nella sezione appropriata della pagina;
3. Salva le modifiche;
4. Testa la pagina prima di pubblicarla sul tuo sito web online;
5. Pubblica la pagina quando l'integrazione si comporta come previsto.

I test in un ambiente privato o di staging ti danno il tempo di modificare il layout, lo stile, le dimensioni o la posizione prima che i visitatori lo utilizzino.

### Perché incorporare l'Agente?

L'incorporamento mantiene l'interazione all'interno del tuo sito web, quindi gli utenti non devono aprire una pagina AIsuru separata.

Puoi anche creare un layout specifico per il sito web e allinearne l'aspetto alla pagina circostante utilizzando le normali opzioni del Layout di condivisione.

### Agenti privati

Se l'Agente è configurato come privato, agli utenti potrebbe essere richiesto di fornire la password dell'Agente prima di poter interagire con esso.

Consulta Accesso e visibilità quando l'esperienza incorporata deve essere limitata a utenti o pubblico specifici.

### Applicazioni web e integrazioni più approfondite

L'embed generato si basa sul Web Component di AIsuru anziché su un'integrazione isolata basata esclusivamente su iframe.

Questo consente alle applicazioni web avanzate di integrare più profondamente l'Agente con la pagina host, ad esempio passando il contesto, reagendo agli eventi dell'Agente, inviando messaggi da elementi di interfaccia personalizzati o coordinando l'Agente con altri contenuti della pagina.

Non hai bisogno di queste funzionalità per un embed standard in un sito web.

Per un'integrazione a livello di sviluppo, consulta [Embed avanzato e integrazione web.](/condivisione/publish-your-agent/advanced-embed-and-web-integration.md)