# AI Tuning

> AI Tuning lets you control how your interview agents behave, what they prioritize, what they evaluate, and how insights are generated.

## Where to Find AI Tuning

1. Go to your **Dashboard**
2. In the sidebar, open **AI**

<figure><img src="/files/mANMZfa76OhzlHK0dZP0" alt="" width="354"><figcaption></figcaption></figure>

3. You'll see these sections:

* **Knowledge Base**
* **Interview Templates**
* **Interview Evaluation**
* **Interview Integrity**
* **Agent Library**
* **Languages & Voices**

Each one controls a different part of your AI agent’s logic and evaluation flow.

## Company Context

This section tells the AI **who you are** and **how candidates should experience your brand**. Settings → Company Context

<figure><img src="/files/Q4oH6cglZ58yOnNOlqrW" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>Company Identity</strong></summary>

Visible to candidates and referenced by the AI during interviews.

* **Company Name:** Shown in interviews and PDFs (max 25 characters)
* **Company Logo:** Upload your logo (JPG, PNG up to 5MB) for interviews and reports

</details>

<details>

<summary><strong>Outreach Settings</strong></summary>

Controls how candidates receive interview links.

* **Default Interview URL:** The base link candidates see in engagement messages
* **Interview Domain:** Select from your configured domains
* **URL Slug:** Customize the URL path for your company
* **Default Sender Email:** Email identity for invites and reminders

</details>

<details>

<summary><strong>Company Location</strong></summary>

* **Company Address:** Used for location context when the AI engages with candidates (helps answer location-related questions accurately)

</details>

<details>

<summary><strong>Candidate Communications</strong></summary>

How do I disable automated e-mail communication from HeyMilo?

* **Turn Off All Candidate Communications:** Master toggle to disable all automated emails and SMS messages sent to candidates. Use this to pause all outreach when needed.

<figure><img src="/files/9dKUWBho34WekyxxJSX4" alt=""><figcaption></figcaption></figure>

</details>

**Why this matters:**

Consistent branding improves candidate trust and reduces drop-off, especially in high-volume workflows.

## Knowledge Base

This section lets you add reference points that help AI interviewers understand your company's preferences and context.

<figure><img src="/files/udvmTrVuFSVTdfozB32x" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>What is the Knowledge Base?</strong></summary>

The Knowledge Base stores information that your AI interviewers can reference during interviews. This helps the AI:

* Understand what you look for in candidates
* Answer candidate questions accurately
* Apply consistent evaluation criteria across interviews

</details>

<details>

<summary>Managing Knowledge Items</summary>

Click **Add Knowledge** to create a new item with:

* **Title:** A descriptive name (e.g., "Candidate Experience Requirements")
* **Tag:** Categorize by type:
  * **General:** Company-wide information
  * **Candidate:** What you look for in candidates
  * **Job Posting:** Role-specific context
  * **Interviews:** Interview process information
* **Content:** The detailed information for the AI to reference
* **Active toggle:** Enable or disable without deleting

</details>

<details>

<summary>Using Knowledge Items</summary>

* Filter items by tag to find specific information
* Toggle items on/off to control what the AI references
* Edit or delete items as your needs change

</details>

**Why this matters:**

Knowledge items ensure your AI interviewers have consistent context across all interviews, reducing the need to repeat information in every interviewer setup.

## Interview Templates

This section lets you create **reusable interview configurations** that can be quickly applied to new job postings. Set one as a default by starring a template!

<figure><img src="/files/llCB1AaeAq3cRNICVwvX" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>What are Interview Templates?</strong></summary>

Interview Templates save your interview setup (questions, settings, screening criteria) so you can reuse them across multiple roles without starting from scratch each time.

Each template includes:

* A unique **template code** for easy reference
* All interview configuration settings
* The ability to set one template as the **default** for new interviewers

</details>

<details>

<summary><strong>Managing Templates</strong></summary>

* **Create Template:** Click "Create Template" to build a new reusable configuration
* **Use Template:** Apply a template to quickly create a new interviewer
* **View:** Preview the template's configuration without editing
* **Edit:** Modify an existing template's settings
* **Set as Default:** Star a template to use it automatically for new interviewers
* **Delete:** Remove templates you no longer need

</details>

<details>

<summary><strong>Template Codes</strong></summary>

Each template gets a unique code (e.g., `ABC123`) that you can copy and share with teammates. Click the code badge to copy it to your clipboard.

</details>

**Why this matters:**

Templates save time when hiring for similar roles repeatedly. Instead of configuring each interviewer from scratch, apply a template and make minor adjustments.

## Interview Evaluation

This section controls **how the AI scores and evaluates candidate language proficiency**.

<figure><img src="/files/46mdYNr4sZLMNBi3yJJO" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>Language Proficiency Templates</strong></summary>

Create evaluation templates for different languages:

* English, Spanish, French, Portuguese, Japanese, Arabic

Each language can have multiple templates (e.g., "Customer Service" vs "Technical Roles"), and you can set one as **active** per language.

</details>

<details>

<summary><strong>Creating and Managing Templates</strong></summary>

* **New Template:** Click "New Template" to create a custom rubric
* **Set Active:** Choose which template to use for interviews in that language
* **Edit:** Click a template to customize its scoring criteria

</details>

<details>

<summary><strong>Scoring Rubric</strong></summary>

Each template defines what scores 1–5 mean for categories like:

* Grammar
* Vocabulary
* Clarity
* Conversational flow

Expand a category to edit the criteria for each score level.

</details>

<details>

<summary><strong>AI Tune</strong></summary>

Use the **AI Tune** button on any category to adjust scoring criteria with natural language:

*Example: "Make scoring more lenient for entry-level roles"*

The AI will rewrite the score definitions based on your instruction.

</details>

**Why this matters:**

Standardized evaluation prevents subjective scoring and keeps hiring fair, especially when multiple recruiters review results.

## Interview Integrity

This section controls interview trust, fraud prevention, and cheat detection rules.

<figure><img src="/files/B7wYm8evNEQVtcGrkiji" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>Enable Cheat Detection</strong></summary>

Toggle cheat detection on or off for all interviews in your workspace. When enabled, the AI monitors for suspicious behaviors during interviews.

</details>

<details>

<summary><strong>Detection Threshold</strong></summary>

Set the sensitivity level from **0 (less sensitive)** to **100 (more sensitive)**.

* Lower values = fewer flags, may miss some issues
* Higher values = more flags, may catch false positives

</details>

<details>

<summary><strong>Detection Types</strong></summary>

Select which behaviors to monitor:

* **Facial Behaviour:** Unusual eye movements or looking away frequently
* **Multiple People:** More than one person visible on camera
* **Phone Detection:** Candidate using a phone during the interview
* **AI/Scripted Answer:** Responses that appear pre-written or AI-generated
* **Unusual Delays:** Long pauses that may indicate looking up answers
* **Tab Switching:** Candidate switching browser tabs during the interview

Use "Select All" or "Deselect All" to quickly toggle all detection types.

</details>

**Why this matters:**

Integrity settings protect interview quality and give recruiters confidence in candidate results, especially for remote or high-stakes roles.

## Agent Library

This section lets you browse and preview the AI agent personas (mascots) available for your interviewers.

<figure><img src="/files/owvvLv4beBBCYCUpGjFe" alt=""><figcaption></figcaption></figure>

<details>

<summary><strong>What are Mascots?</strong></summary>

Mascots are the visual and personality representations of your AI interviewers. Each mascot has:

* A unique name and appearance
* A distinct personality and communication style
* A specific role in the recruitment process

Examples include Milo (the main interviewer), Sally (the sourcer), and Chloe (the receptionist).

</details>

<details>

<summary><strong>Using the Agent Library</strong></summary>

* Browse available mascots and their descriptions
* Preview how each mascot looks and communicates
* Select mascots when creating new interviewers

</details>

**Why this matters:**

Choosing the right mascot helps create a consistent and branded candidate experience that aligns with your company culture.

## Languages & Voices

This section shows all available languages and voice options for your AI interviewers.

Voices are powered by LMNT and Cartesia.

<figure><img src="/files/f1FpJieiZBA0yQJeUtX4" alt=""><figcaption></figcaption></figure>

Use Browse Voice Providers to filter by provider, search by name, preview with the play button, and add voices to your workspace; those voices then appear in the voice dropdown when you create or edit an interviewer.

<details>

<summary><strong>Available Languages</strong></summary>

HeyMilo supports interviews in multiple languages including:

* English (US, UK, Australia, and more)
* Spanish
* French
* And many other languages

Each language has multiple voice options to choose from.

</details>

<details>

<summary><strong>Previewing Voices</strong></summary>

* Search by language, country, or voice name
* Click the play button to hear voice samples
* Compare different voices before selecting one for your interviewer

</details>

**Why this matters:**

Selecting the right language and voice ensures candidates can interview in their preferred language and creates a more natural and comfortable experience.

## Best Practices for AI Tuning

* Keep **Company Context** concise — just enough for the AI to represent your brand
* Add key information to your **Knowledge Base** so it's available across all interviewers
* Create **Interview Templates** for roles you hire repeatedly to save setup time
* Use **AI Tune** in Evaluation to customize scoring criteria with natural language
* Enable **Cheat Detection** for high-volume or skills-based interviews
* Preview **voices** in Languages & Voices before selecting one for your brand
* Treat AI Tuning as your **foundation** — interviewers inherit these defaults automatically


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.admin.heymilo.ai/white-labeling/ai-tuning.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.