> ## 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.

# Arya AI settings

> Configura provider AI, modelli, parametri di generazione, BYOK.

Configura come Arya usa l'AI: quale provider, quale modello, parametri di generazione, limiti di costo.

## Provider AI

<Tabs>
  <Tab title="Arya managed (default)">
    Arya gestisce tutto: infrastruttura, provider (mix di Anthropic Claude, OpenAI GPT, Google Gemini), routing automatico al modello più adatto. Costi inclusi nei crediti.
  </Tab>

  <Tab title="BYOK (Bring Your Own Key)">
    Usi la tua API key (OpenAI, Anthropic, Azure OpenAI). Costi direttamente col provider, Arya non fattura crediti AI.
  </Tab>

  <Tab title="Private deployment (Enterprise)">
    Modelli dedicati su infrastruttura privata (AWS/Azure/on-prem). Per esigenze di data residency o performance.
  </Tab>
</Tabs>

## Configura BYOK

<Steps>
  <Step title="Impostazioni → AI → Provider → BYOK">Scegli OpenAI o Anthropic.</Step>
  <Step title="Incolla API key">Generata dal portale del provider.</Step>
  <Step title="Testa">Arya invia richiesta di test. Se funziona, salva.</Step>

  <Step title="Scegli modello">
    Per OpenAI: gpt-4.1, gpt-4o, o3, o4-mini, ecc.
    Per Anthropic: claude-opus-4, claude-sonnet-4-6, claude-haiku-4-5, ecc.
  </Step>
</Steps>

## Parametri

<AccordionGroup>
  <Accordion title="Temperatura">
    0 = deterministico, 1 = creativo. Default 0.3 (bilanciato).

    * Bassa per dati strutturati, classificazioni
    * Alta per brainstorming, creatività
  </Accordion>

  <Accordion title="Max tokens">
    Lunghezza massima output. Default 2000.
  </Accordion>

  <Accordion title="Reasoning level (solo modelli compatibili)">
    Quanto "pensa" prima di rispondere. Alto = risposte più accurate ma più lente e costose.
  </Accordion>

  <Accordion title="Verbose mode">
    Mostra step-by-step del ragionamento. Utile per debug, superfluo per uso normale.
  </Accordion>
</AccordionGroup>

## Limiti di costo

Per evitare consumi imprevisti:

<Steps>
  <Step title="Budget mensile">Soglia crediti. Oltre → Arya blocca richieste non essenziali.</Step>
  <Step title="Budget per utente">Limita consumo individuale.</Step>
  <Step title="Alert soglie">70% quota → email; 90% → notifica; 100% → blocco.</Step>
</Steps>

## Funzionalità AI attivabili

Scegli cosa Arya può fare con l'AI:

<CardGroup cols={2}>
  <Card title="AryaChat">Chat conversazionale.</Card>
  <Card title="Document generation">Email, contratti, preventivi.</Card>
  <Card title="Call intelligence">Trascrizione + riassunto chiamate.</Card>
  <Card title="Report chat">Analisi dati in linguaggio naturale.</Card>
  <Card title="Data enrichment">Arricchimento aziende e contatti.</Card>
  <Card title="OCR ricevute">Note spese da foto.</Card>
  <Card title="Auto-tagging">Classificazione automatica record.</Card>
  <Card title="Smart suggestions">Suggerimenti proattivi (next-best-action).</Card>
</CardGroup>

Disattiva quelle che non ti servono per risparmiare crediti.

## Privacy AI

<Note>
  * **Arya managed**: conformità GDPR, nessun uso per training di modelli globali
  * **BYOK OpenAI/Anthropic**: soggetti alle policy del provider. Verifica che abbiano zero-retention se hai dati sensibili.
  * **Private deployment**: dati mai escono dalla tua infrastruttura.
</Note>

## Monitor usage

Dashboard **Impostazioni → AI → Analytics**:

* Consumo per feature
* Consumo per utente
* Trend temporale
* Query più costose (per ottimizzazione)

## Domande frequenti

<AccordionGroup>
  <Accordion title="Qual è il provider migliore?">Dipende dal caso d'uso. Claude eccelle in ragionamento lungo e analisi. GPT in creatività e codice. Arya managed instrada automaticamente al migliore per ogni compito.</Accordion>
  <Accordion title="Posso usare modelli open-source (Llama, Mistral)?">Su piani Enterprise con private deployment, sì. Su piani standard no.</Accordion>
</AccordionGroup>