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

# Lesson 10 — AryaChat and AI credits

> How credits work, where to activate Arya, prompt best practices.

<Note>
  **Lesson 10 of 10** · \~4 minutes · Prerequisite: [Lesson 9 — Reports and dashboards](/en/arya-101/lesson-9-reports-and-dashboards)
</Note>

## What you'll learn

* Where and how to activate Arya's AI
* How AI credits work
* Best practices for effective prompts

## Where you meet AI in Arya

AI is embedded in strategic spots across the platform:

<CardGroup cols={2}>
  <Card title="AryaChat" icon="message">
    Conversational chat with full workspace context. Available from the sidebar or with `⌘+K`.
  </Card>

  <Card title="Contextual sidebar" icon="panel-right">
    On every record (deal, company, task) Arya suggests next steps based on the data.
  </Card>

  <Card title="Report Chat" icon="chart-mixed">
    Ask dashboards questions in natural language.
  </Card>

  <Card title="Document generation" icon="file-pen">
    Create emails, proposals, summaries from the record context.
  </Card>

  <Card title="Call intelligence" icon="phone">
    Automatic transcription, summaries, action items extracted from calls.
  </Card>

  <Card title="Data enrichment" icon="wand-magic-sparkles">
    Select a group of companies and ask Arya to fill missing fields.
  </Card>
</CardGroup>

## AryaChat in practice

<Steps>
  <Step title="Open the chat">
    Click the chat icon top-right or press `⌘+K` (Mac) / `Ctrl+K` (Windows).

    <Frame>
      <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/arya-101/lesson-10/en/aryachat.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=41cfcbad6c659977b8553d5cbce72c25" alt="AryaChat interface with conversation thread and input bar" width="1200" height="720" data-path="images/arya-101/lesson-10/en/aryachat.svg" />
    </Frame>
  </Step>

  <Step title="Ask a question">
    Write in English or Italian. Examples:

    * *"Show me the 5 largest open deals"* → Arya replies with a clickable table
    * *"Create a task to call Mario Rossi tomorrow"* → Arya creates the task (asks for confirmation)
    * *"Summarise the last month of activity on Acme Corp"* → structured answer with key events
    * *"Write a professional follow-up email on this quote"* → ready-to-send draft
  </Step>

  <Step title="Confirm actions">
    For actions that modify data (create records, send emails) Arya always asks for confirmation. You can also undo right after.
  </Step>

  <Step title="Voice input">
    Click the microphone icon → speak. Arya transcribes and replies. Useful on mobile.
  </Step>
</Steps>

## AI credits

AI use consumes **credits**. Every plan includes a monthly quota; beyond that you can:

* Wait for next month's reset
* Buy additional credits
* Use your own OpenAI/Anthropic API key (BYOK)

### Approximate consumption

| Action                        | Cost           |
| ----------------------------- | -------------- |
| Simple chat question          | 1-3 credits    |
| Report Chat with analysis     | 5-15 credits   |
| Email/document generation     | 10-30 credits  |
| Call transcription (60 min)   | 50-100 credits |
| Call summary                  | 10-20 credits  |
| Company enrichment (with web) | 5-10 credits   |

### Monitor usage

In **Settings → Arya AI** you see:

* Available credits
* Usage history per user and type
* Detailed call logs (Agent logs)

<Frame>
  <img src="https://mintcdn.com/agevole/BUuJGD62nuns4mJL/images/arya-101/lesson-10/en/ai-credits-panel.svg?fit=max&auto=format&n=BUuJGD62nuns4mJL&q=85&s=1876c7c3c228647347569e6f2db2fae9" alt="AI credits panel with balance and monthly usage chart" width="1200" height="720" data-path="images/arya-101/lesson-10/en/ai-credits-panel.svg" />
</Frame>

### Earn credits

For every referred workspace that becomes paying, you receive **€10 in AI credits** (non-expiring). See [Referral program](/en/cross-features/referral-program).

## Bring your own key

If you prefer to use OpenAI or Anthropic directly:

<Steps>
  <Step title="Get an API key">
    Generate a key at [platform.openai.com](https://platform.openai.com) or [console.anthropic.com](https://console.anthropic.com).
  </Step>

  <Step title="Paste into Arya">
    **Settings → Arya AI → Provider** → select `OpenAI (BYOK)` or `Anthropic (BYOK)` → paste the key.
  </Step>

  <Step title="Pick the model">
    Select which model to use (e.g. `gpt-4.1`, `claude-sonnet-4-6`). Params: temperature, reasoning verbosity.
  </Step>
</Steps>

From that point Arya uses your provider: no Arya credits consumed, you pay the provider directly.

## Prompt best practices

<AccordionGroup>
  <Accordion title="Be specific about context">
    ❌ *"Write a follow-up email"*
    ✅ *"Write a follow-up email to Mario Rossi at Acme Corp about the quote sent yesterday, professional but casual tone, short length, in Italian"*
  </Accordion>

  <Accordion title="Use record references">
    When you're on a deal page, Arya already has the deal context. Just say: *"Draft me a script for the next call"* — no need to repeat the data.
  </Accordion>

  <Accordion title="Iterate">
    If the first reply isn't perfect: *"Shorter"*, *"Add a reference to expected ROI"*, *"Change to a more formal tone"*.
  </Accordion>

  <Accordion title="Leverage threads">
    AryaChat keeps thread memory. Keep working on the same context instead of opening new chats for every question.
  </Accordion>
</AccordionGroup>

## Verify

<Check>You tried AryaChat with at least three different questions</Check>
<Check>You know where to check credit balance and usage history</Check>
<Check>You know how to connect your own API key if you prefer BYOK</Check>

## You finished Arya 101!

Congratulations. You now know the fundamentals of Arya Nest.

<CardGroup cols={2}>
  <Card title="Module deep dives" icon="book" href="/en/crm/overview">
    Detailed guides for every platform section.
  </Card>

  <Card title="Mobile app" icon="mobile" href="/en/mobile/overview">
    How to use Arya on iOS and Android.
  </Card>

  <Card title="Advanced automations" icon="bolt" href="/en/automations/overview">
    Webhooks, branching, loops, complex integrations.
  </Card>

  <Card title="Reference" icon="circle-question" href="/en/faq">
    Glossary, keyboard shortcuts, FAQs.
  </Card>
</CardGroup>