# Il suo primo agent

} from '../../../../components/docs';

La registrazione ha già creato il suo primo agent dai dettagli della sua azienda e le ha consegnato una linea di test. Questa pagina è ciò che fa dopo: apra quell'agent, configuri come parla, lo provi e riveda la chiamata.

Il nome dell'agent proviene dall'attivazione (per esempio **Agent Of Voice Logica Docs** quando l'azienda è Voice Logica Docs). Può rinominarlo più tardi in **Instructions** - non ha bisogno di ricrearlo.

> **Non inizi con Create agent:** **Non** inizia cliccando su **Create agent**. Quel pulsante è per un *secondo* agent, e la maggior parte dei nuovi piani include solo uno.
## Apra My Agents

Nella barra laterale, apra **AI agents**. L'intestazione della pagina è **My Agents**.

  <ShotPlaceholder
    src="/assets/getting-started/first-agent-1.png"
    name="first-agent-1"
    alt="Lista My Agents con l'agent di attivazione"
    capture="My Agents - una card agent di attivazione."
  />

Cosa vede:

- **Create agent** - aggiunge un altro agent se il suo piano lo permette (spesso mostra un lucchetto quando è già al limite)
- **Copy agent** - duplica un agent esistente quando il suo piano lo permette
- **Add filter** e **Search agents...** - restringono la lista
- Una card agent dall'attivazione - nome, quanto recentemente è stato toccato, un chip ID breve, **View calls**, e azioni rapide sulla card

Clicchi sulla card dell'agent per aprire l'editor.

### Aggiungere un altro agent

Clicchi su **Create agent**. Se il suo piano include solo un agent, appare **Agent limit reached** con **Your plan includes 1 agent - upgrade to add more.** Scelga **View subscription** per aggiornare, o **Cancel** e continui a personalizzare l'agent che ha.

  <ShotPlaceholder
    src="/assets/getting-started/first-agent-5.png"
    name="first-agent-5"
    alt="Dialogo Agent limit reached"
    capture="Create agent - pannello Agent limit reached."
  />

## L'editor dell'agent

L'intestazione dell'editor mostra il nome dell'agent, un badge verde **Live / v1**, e **Prompt Based - editing the live agent.**

Quattro controlli dell'intestazione si trovano sopra le schede:

- **Required** — Controlli di prontezza. Apre **Not ready for calls** con elementi richiesti e avvisi prima che i chiamanti possano raggiungere l'agent.
- **Edit with AI** (narrow: AI) — Apre Claude / ChatGPT per questo agent (necessita di una connessione AI).
- **Live on** — Su quali canali questo agent risponde. **0 of 2 channels** significa che Try this agent può funzionare mentre i clienti ancora non possono raggiungerlo.
- **Try this agent** (narrow: Try) — Due modi per sentire l'agent prima che lo facciano i chiamanti reali.

  <ShotPlaceholder
    src="/assets/getting-started/first-agent-required.png"
    name="first-agent-required"
    alt="Checklist Required Not ready for calls"
    capture="Pannello Required dell'intestazione editor aperto."
  />

**Required** può elencare blocchi come **Telephony** (i chiamanti non possono ancora raggiungere l'agent), più avvisi come strumenti menzionati nel prompt che non sono abilitati, o divulgazione AI mancante dal saluto. Non c'è un passaggio di pubblicazione separato - il salvataggio aggiorna l'agent attivo.

### Rimanga su Identity

Per la prima settimana ha bisogno solo di **Instructions** e **Voice & Language**. Le altre aree della barra sono il riferimento [Configurazione Agent](https://docs.voicelogica.ai/agent-configuration/advanced-agent/) - lo apra dopo una buona chiamata di test.

  <ShotPlaceholder
    src="/assets/getting-started/first-agent-2.png"
    name="first-agent-2"
    alt="Scheda Instructions con Basic Info e Greeting"
    capture="Identity - Instructions (Basic Info + Greeting)."
  />

- **Identity** — Instructions, Voice & Language

## Identity - Instructions

Tre sezioni:

1. **Basic Info**

- **Agent name** (required) — Il nome che i chiamanti e il suo team vedono nelle chat e nei registri chiamate. L'attivazione lo compila dai dettagli della sua azienda.
- **Internal dial extension** — `410` — Componga questo da qualsiasi telefono interno. Il sistema lo assegna - non può essere cambiato.
- **Advanced - Reply style** — Lo apra solo se ha bisogno di regolare come vengono formulate le risposte.

2. **Greeting**

- **AI disclosure** — Quando attivo, ai chiamanti viene detto che stanno parlando con un'IA se il suo saluto non lo dice già. Voice Logica evidenzia qui l'**Articolo 50(1) e 50(5)** dell'EU AI Act. Se il toggle è spento e il saluto non divulga l'IA, lei (il distributore) potrebbe non essere conforme.
- **Welcome message** — La prima cosa che i chiamanti sentono. Usi **Insert greeting** per una riga di partenza. Lo mantenga breve.
- **Advanced - Greeting** — Opzioni di saluto extra.

3. **AI personality & behavior**

   Questo è il system prompt - la leva più grande sulla qualità delle chiamate. Copra:

   - Il ruolo dell'agent e l'azienda che rappresenta
   - Tono (professionale, caloroso, formale, casual)
   - Cosa raccogliere, cosa rifiutare, quando trasferire o riagganciare
   - Come gestire domande comuni

   Controlli sopra il prompt:

- **Prompt history** — Ripristini una versione precedente.
- **Insert variable** — Valori live come il numero del chiamante o la data di oggi. Usi `{{variable_name}}`.
- **Word pronunciation** — Insegni nomi di brand e acronimi.
- **Improve with AI** — Raffini il prompt sul posto.

   Un contatore di caratteri si trova sotto il prompt (dipendente dal piano, per esempio `5,121 / 10,000`). Se finisce lo spazio, sposti il materiale di riferimento in una base di conoscenza invece di riempire il prompt.

> **Sia specifico:** Un prompt dettagliato è il singolo fattore più grande nella qualità dell'agent. Scriva il lavoro come brieferebbe un nuovo receptionist al primo giorno.
## Identity - Voice & Language

Scelga prima una lingua primaria e una voce. Aggiunga lingue secondarie più tardi per i chiamanti che le preferiscono.

- **Primary Language & Voice** - **Primary language** è la lingua con cui l'agent inizia ogni chiamata. **Voice** è la voce parlante; **Preview** riproduce un campione, **Change voice** apre il catalogo. **Advanced - Voice tuning** è collassato di default.
- **Secondary Languages** - **Add language** così l'agent può rilevare e passare quando un chiamante preferisce un'altra lingua.
- **Call Background Audio** - suono ambientale opzionale (ufficio, caffè) così la linea si sente meno vuota.
- **Accuracy** - **Custom vocabulary** per nomi e termini non comuni. Digiti una parola e prema Invio o virgola.

  <ShotPlaceholder
    src="/assets/getting-started/first-agent-voice.png"
    name="first-agent-voice"
    alt="Voice and Language - lingua primaria e voce"
    capture="Identity - Voice and Language."
  />

> **Ascolti prima:** Ascolti l'anteprima della voce prima di lasciare la scheda. I chiamanti sentono questo ad ogni chiamata.
## Try this agent

Clicchi su **Try this agent** nell'intestazione dell'editor. Il titolo del pannello è **Try this agent. Two ways to hear it before callers do.**

  <ShotPlaceholder
    src="/assets/getting-started/first-agent-3.png"
    name="first-agent-3"
    alt="Pannello Try this agent con opzioni browser e telefono"
    capture="Intestazione editor - Try this agent. Numero di test e PIN oscurati."
  />

1. **Parli con esso nel suo browser**

   Usa il suo microfono. Niente va live. Questo è il ciclo più veloce mentre modifica il saluto o il prompt.

2. **Lo chiami dal suo telefono**

   Componga il numero di test, poi inserisca il PIN (con `#`). **Dial** e **Copy** sono sul pannello.

   Questa è la stessa linea di test che ha ricevuto alla fine della [registrazione](https://docs.voicelogica.ai/it/getting-started/sign-up/).

3. **Riveda la conversazione**

   Apra **Calls** nella barra laterale (o **View calls** sulla card dell'agent). Usi la scheda **History** (potrebbe mostrare un conteggio) e **Scheduled**. Ogni riga mostra il chiamante, canale, agent, data, durata e stato (per esempio **Answered**).

     <ShotPlaceholder
       src="/assets/getting-started/first-agent-4.png"
       name="first-agent-4"
       alt="Calls History con una chiamata di test risposta"
       capture="Calls - History con una chiamata di test risposta. Numeri chiamante oscurati."
     />

   Apra una chiamata per ascoltare la registrazione e leggere la trascrizione, poi torni a **Instructions** o **Voice & Language** e aggiusti.

> **I salvataggi vanno live:** Il footer dell'editor è letterale: **You are editing the live version - Saved changes go to callers.** Testi dopo ogni modifica significativa, non solo alla fine.
## Andare live per i clienti

**Try this agent** è una linea di prova privata. I clienti reali raggiungono l'agent attraverso un canale. Apra **Live on** nell'intestazione per vedere **Channels**.

  <ShotPlaceholder
    src="/assets/getting-started/first-agent-live-on.png"
    name="first-agent-live-on"
    alt="Pannello Live on Channels"
    capture="Intestazione editor Live on / pannello Channels."
  />

1. Controlli **0 of 2 channels** e la riga di stato (per esempio **Not reachable on any channel yet**).
2. Attivi **Website Widget**, o usi **Telephony** → **Connect** per collegare un numero - veda [Numeri di telefono Voice Logica](https://docs.voicelogica.ai/telephony/voice-logica-numbers/).
3. Mantenga un [abbonamento](https://docs.voicelogica.ai/it/getting-started/activate-subscription/) a pagamento così ha minuti per il traffico reale.

Poi metta il numero sul suo sito web, firme email e inserzioni.

## Checklist della prima settimana

1. **Apra l'agent di attivazione** - non ne crei un secondo fino a quando non ne ha bisogno.
2. **Riscriva il saluto** - i chiamanti dovrebbero sapere chi hanno raggiunto nei primi secondi, inclusa la divulgazione AI se la legge nella sua regione lo richiede.
3. **Scriva un prompt di personalità specifico** - ruolo, tono, cosa raccogliere, quando trasferire.
4. **Scelga lingua e voce** - ascolti l'anteprima del campione prima di salvare.
5. **Lo provi, poi apra Calls** - browser o telefono, poi ascolti e iteri.

## Risoluzione dei problemi

**Non riesco a trovare una procedura guidata Create agent per il mio primo agent**

Quella procedura guidata è scomparsa dal percorso del nuovo utente. La registrazione ha già creato l'agent quando ha finito il modulo dell'attività. Apra **AI agents** / **My Agents** e clicchi sulla card che è già lì.

**Create agent dice Agent limit reached**

Il suo piano include un numero fisso di agent (spesso **1** sul Demo e il primo livello a pagamento). Clicchi su **View subscription** per aggiornare, o continui a configurare l'agent esistente. Gli agent extra sono un limite del piano, non un bug del prodotto.

**Cosa significa il pulsante Required?**

**Required** apre **Not ready for calls**. Gli elementi richiesti bloccano i chiamanti reali (per esempio **Telephony** non collegato). Gli avvisi segnalano discordanze come strumenti menzionati nel prompt che sono ancora spenti, o divulgazione AI mancante dal saluto. Risolva ogni elemento e il chip si cancella.

**Devo attivare AI disclosure?**

Se il suo saluto dice già che il chiamante sta parlando con un'IA, può lasciare il toggle spento. Se non lo dice, attivi **AI disclosure**. Sotto l'**Articolo 50(1) e 50(5)** dell'EU AI Act, ai chiamanti deve essere detto alla prima interazione che stanno parlando con un'IA. Lei è il distributore - Voice Logica evidenzia il promemoria; la conformità è sua.

**Dove è andata la linea di test?**

Vive sotto **Try this agent** nell'intestazione dell'editor - non come un banner permanente. Apra il pannello per **Talk to it in your browser** o **Call it from your phone** (numero + PIN).

**Devo pubblicare dopo aver salvato?**

No. Salvare aggiorna l'agent attivo (**Live / v1**). Non c'è pubblicazione di staging. Il footer la ricorda: le modifiche salvate vanno ai chiamanti.

## Prossimi passi

> **Dopo la prima buona chiamata di test:** Apra **[Configurazione Agent](https://docs.voicelogica.ai/agent-configuration/advanced-agent/)** - una mappa delle schede rimanenti. Inizi con [Conoscenza](https://docs.voicelogica.ai/agent-configuration/memory/), poi [Riagganciare](https://docs.voicelogica.ai/agent-configuration/end-call/), poi [Risultati chiamata](https://docs.voicelogica.ai/agent-configuration/call-results/). Identity rimane su questa pagina.
## Ha bisogno di aiuto?

- EMAIL [support@voicelogica.ai](mailto:support@voicelogica.ai)
- DOCUMENTAZIONE [docs.voicelogica.ai](https://docs.voicelogica.ai)
- CHAT DAL VIVO Disponibile nella sua dashboard tramite il pulsante Support