> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arya.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Lezione 10 — AryaChat e crediti AI

> Come funzionano i crediti, dove attivare Arya, best practice di prompt.

<Note>
  **Lezione 10 di 10** · Circa 4 minuti · Prerequisito: [Lezione 9 — Report e dashboard](/it/arya-101/lezione-9-report-e-dashboard)
</Note>

## Cosa imparerai

* Dove e come attivare l'AI di Arya
* Come funzionano i crediti AI
* Best practice per prompt efficaci

## Dove incontri l'AI in Arya

L'AI è integrata in punti strategici di tutta la piattaforma:

<CardGroup cols={2}>
  <Card title="AryaChat" icon="message">
    Chat conversazionale con tutto il contesto del tuo workspace. Disponibile dalla sidebar o con la scorciatoia `⌘+K`.
  </Card>

  <Card title="Sidebar contestuale" icon="panel-right">
    Su ogni record (deal, azienda, task) Arya suggerisce i prossimi passi sulla base dei dati.
  </Card>

  <Card title="Report Chat" icon="chart-mixed">
    Fai domande in linguaggio naturale sulle tue dashboard.
  </Card>

  <Card title="Generazione documenti" icon="file-pen">
    Crea email, proposte, riepiloghi direttamente dal contesto del record.
  </Card>

  <Card title="Call Intelligence" icon="phone">
    Trascrizione automatica, riassunti, action items estratti dalle chiamate.
  </Card>

  <Card title="Arricchimento dati" icon="wand-magic-sparkles">
    Seleziona un gruppo di aziende e chiedi ad Arya di completare i campi mancanti.
  </Card>
</CardGroup>

## AryaChat in pratica

<Steps>
  <Step title="Apri la chat">
    Click sull'icona chat in alto a destra, oppure premi `⌘+K` (Mac) o `Ctrl+K` (Windows).

    <Frame>
      <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/arya-101/lesson-10/it/aryachat.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=ae941034b0dfe07d6de88f78785e310e" alt="Interfaccia AryaChat con thread di conversazione e barra input" width="1200" height="720" data-path="images/arya-101/lesson-10/it/aryachat.svg" />
    </Frame>
  </Step>

  <Step title="Fai una domanda">
    Scrivi in italiano o inglese. Esempi:

    * *"Mostrami i 5 deal più grossi aperti"* → Arya risponde con tabella cliccabile
    * *"Crea un task per richiamare Mario Rossi domani"* → Arya crea il task (ti chiede conferma)
    * *"Riassumi l'ultimo mese di attività su Acme SpA"* → risposta strutturata con eventi chiave
    * *"Scrivi un'email di follow-up professionale su questo preventivo"* → draft pronto da inviare
  </Step>

  <Step title="Conferma le azioni">
    Per azioni che modificano dati (creare record, inviare email), Arya chiede sempre conferma prima di eseguire. Puoi anche annullare subito dopo (undo).
  </Step>

  <Step title="Input vocale">
    Click sull'icona microfono → parla. Arya trascrive e risponde. Utile da mobile.
  </Step>
</Steps>

## Crediti AI

L'uso dell'AI consuma **crediti**. Ogni piano include una quota mensile, oltre la quale puoi:

* Aspettare il rinnovo del mese successivo
* Acquistare crediti aggiuntivi
* Usare una tua API key OpenAI/Anthropic (consumi il tuo credito invece di quelli Arya)

### Come vengono consumati

Consumo approssimativo per azione:

| Azione                          | Costo          |
| ------------------------------- | -------------- |
| Domanda semplice in chat        | 1-3 crediti    |
| Report Chat con analisi         | 5-15 crediti   |
| Generazione email/documento     | 10-30 crediti  |
| Trascrizione chiamata (60 min)  | 50-100 crediti |
| Riassunto chiamata              | 10-20 crediti  |
| Arricchimento azienda (con web) | 5-10 crediti   |

### Monitora il consumo

Da **Impostazioni → Arya AI** vedi:

* Crediti disponibili
* Storico consumo per utente e per tipologia
* Log dettagliato delle chiamate (Agent logs)

<Frame>
  <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/arya-101/lesson-10/it/ai-credits-panel.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=f3657b3e5962a1de30526b96ec954ec4" alt="Pannello crediti AI con saldo e grafico consumo mensile" width="1200" height="720" data-path="images/arya-101/lesson-10/it/ai-credits-panel.svg" />
</Frame>

### Guadagna crediti

Per ogni workspace referral che diventa cliente pagante, ricevi **10 € di crediti AI** (non scadono). Vedi [Programma referral](/it/trasversali/programma-referral).

## Usa la tua API key

Se preferisci usare direttamente OpenAI o Anthropic:

<Steps>
  <Step title="Ottieni una API key">
    Genera una chiave su [platform.openai.com](https://platform.openai.com) o [console.anthropic.com](https://console.anthropic.com).
  </Step>

  <Step title="Incollala in Arya">
    **Impostazioni → Arya AI → Provider** → seleziona `OpenAI (BYOK)` o `Anthropic (BYOK)` → incolla la key.
  </Step>

  <Step title="Scegli il modello">
    Seleziona quale modello usare (es. `gpt-4.1`, `claude-sonnet-4-6`). Parametri: temperatura, verbosity del reasoning.
  </Step>
</Steps>

Da quel momento Arya usa il tuo provider: nessun credito Arya consumato, paghi direttamente il provider.

## Best practice di prompt

<AccordionGroup>
  <Accordion title="Sii specifico sul contesto">
    ❌ *"Scrivi un'email di follow-up"*
    ✅ *"Scrivi un'email di follow-up a Mario Rossi di Acme SpA sul preventivo inviato ieri, tono professionale ma informale, lunghezza breve, in italiano"*
  </Accordion>

  <Accordion title="Usa i riferimenti ai record">
    Quando sei su una pagina deal, Arya ha già tutto il contesto del deal. Basta dire: *"Preparami uno script per la prossima call"* — non serve ripetere i dati.
  </Accordion>

  <Accordion title="Chiedi iterazioni">
    Se la prima risposta non è perfetta: *"Rifallo più corto"*, *"Aggiungi un riferimento al ROI atteso"*, *"Cambia tono più formale"*.
  </Accordion>

  <Accordion title="Sfrutta i thread">
    AryaChat mantiene la memoria del thread. Continua a lavorare sullo stesso contesto invece di aprire chat nuove per ogni domanda.
  </Accordion>
</AccordionGroup>

## Verifica

<Check>Hai provato AryaChat con almeno tre domande diverse</Check>
<Check>Sai dove controllare il saldo crediti e lo storico consumo</Check>
<Check>Sai come collegare una tua API key se preferisci il BYOK</Check>

## Hai finito Arya 101!

Congratulazioni. Ora conosci i fondamentali di Arya Nest.

<CardGroup cols={2}>
  <Card title="Approfondisci per modulo" icon="book" href="/it/crm/overview">
    Guide dettagliate per ogni sezione della piattaforma.
  </Card>

  <Card title="App mobile" icon="mobile" href="/it/mobile/overview">
    Come usare Arya da iOS e Android.
  </Card>

  <Card title="Automazioni avanzate" icon="bolt" href="/it/automazioni/overview">
    Webhook, branching, loop, integrazioni complesse.
  </Card>

  <Card title="Riferimenti" icon="circle-question" href="/it/faq">
    Glossario, scorciatoie tastiera, FAQ.
  </Card>
</CardGroup>