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

# Settings

Properly configuring your agent is essential for accuracy, performance, and reliability. The **Settings** section lets you manage prompts, models, query behavior, and search precision.

***

## Settings Navigation

<CardGroup cols={2}>
  <Card title="Agent Settings: Part 1" icon="star" href="#agent-settings-part-1">
    Set Chat & Embedding Models
  </Card>

  <Card title="Agent Settings: Part 2" icon="chart-simple" href="#agent-settings-part-2">
    Prompt Types & Prompt Library
  </Card>

  <Card title="Agent Settings: Part 3" icon="sliders" href="#agent-settings-part-3">
    Adjust Agent Temperature
  </Card>

  <Card title="Starter Questions" icon="message" href="#starter-questions">
    Define Starter Prompts
  </Card>

  <Card title="Query Parameters" icon="sliders" href="#query-parameters">
    Pass Contextual Inputs to Agent
  </Card>

  <Card title="Semantic Similarity Score" icon="scale" href="#semantic-search-similarity">
    Fine-Tune Result Relevance
  </Card>
</CardGroup>

***

## Agent Settings: Part 1

Configure the base models for your agent.

* Navigate to **Agent Settings**
* Update the **Agent name** (if needed)
* Choose your **Chat model**
* Select an **Embedding model**
* Save the settings

<Frame caption="Agent Settings: General Configuration">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/settings.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=74f16cfa4db6645d4444a7ff11817929" alt="Agent Settings Part 1" width="2000" height="1066" data-path="images_new/agentsconsole/settings/settings.png" />
</Frame>

***

## Agent Settings: Part 2 – Prompts & Library

### ✅ Configure Prompt Behavior

* **Prompt for Own Data**: Agent only responds using provided data. No hallucinations — replies with *“I don’t know”* if unsure.
* **Prompt for Web Data**: Good for standalone, follow-up questions without context.
* **Prompt Library**: Use system-defined prompts for use cases like Interviewer, Educator, or Assistant.

<Frame caption="Prompt Configuration Panel in Agent Settings">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/promptchoice.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=7fc36e500b5381c9224c613e4cebea83" alt="Prompt Configuration" width="2000" height="1066" data-path="images_new/agentsconsole/settings/promptchoice.png" />
</Frame>

Let’s now look at how to explore and apply these predefined prompts.

***

### Using the Prompt Library

<Steps>
  <Step title="Browse and Apply Predefined Prompts">
    Click **Prompt lib** to access the built-in library of system prompts.\
    Select a category that matches your agent's purpose — e.g., Position Interviewer, Storyteller, FAQ Agent.

    <Frame caption="Prompt Library: Browse Built-in Prompt Options">
      <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/promptlib.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=d33d81273a02cb142ebf1f766882b469" alt="Prompt Library View" width="2000" height="1066" data-path="images_new/agentsconsole/settings/promptlib.png" />
    </Frame>
  </Step>

  <Step title="Preview and Confirm Selection">
    After selecting a prompt, preview its description and sample usage.\
    Click **Use Prompt** to confirm and apply it to your agent.

    <Frame caption="Prompt Confirmation: View & Confirm Prebuilt Prompt">
      <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/useprompt.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=78cf0af220bb5975d6eba6bee85db401" alt="Prompt Confirmation Dialog" width="2000" height="1066" data-path="images_new/agentsconsole/settings/useprompt.png" />
    </Frame>
  </Step>
</Steps>

***

## Agent Settings: Part 3 - Temperature

Control the creativity or precision of your agent responses:

* `0.0 – 0.3`: Very accurate and focused
* `0.4 – 0.7`: Balanced response generation
* `0.8 – 1.0`: More imaginative and open-ended

<Frame caption="Agent Settings: Adjusting Response Temperature">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/temp.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=ac504584ec30dd8a98f24222dcf0948a" alt="Temperature Setting" width="2000" height="1066" data-path="images_new/agentsconsole/settings/temp.png" />
</Frame>

***

## Starter Questions

Let users quickly start conversations with predefined questions.

### How to Add Starter Questions

* Go to **Agent Settings → Starter Questions**
* Add up to 4 questions relevant to your agent
* Click **Add** and then **Save**

<Frame caption="Starter Questions: Configuration Screen">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/addquestion.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=2756e3f71212e93dd34ced655ea2d2b8" alt="Starter Config" width="2000" height="1066" data-path="images_new/agentsconsole/settings/addquestion.png" />
</Frame>

Add up to 4 questions relevant to your agent:

<Frame caption="Starter Questions: Configure Screen">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/savequestion.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=c5fb422fd7cb6f18ad34c6b780939a2a" alt="Starter Config 2" width="2000" height="1066" data-path="images_new/agentsconsole/settings/savequestion.png" />
</Frame>

To preview how your saved starter questions look in your console and user experience:

<Frame caption="Starter Questions: Display in Playground">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/testquestion.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=4f799860a761dc41b78198b9d908d3d6" alt="Playground View with Starter Questions" width="2000" height="1066" data-path="images_new/agentsconsole/settings/testquestion.png" />
</Frame>

***

## Query Parameters

Query parameters allow you to inject dynamic data — like user ID, department, or context — directly into your agent’s logic.

### How to Add Query Parameters

* Go to **Agent Settings**
* Click **Add Query Parameter**
* Provide a name and reference in your prompt
* Save the changes

<Frame caption="Query Parameters: Configuration in Settings">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/addquery.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=d551035eb7802c823b5e634cb84a0f67" alt="Add Query Param" width="2000" height="1066" data-path="images_new/agentsconsole/settings/addquery.png" />
</Frame>

Then, test the parameter live in the Playground UI:

<Frame caption="Query Parameters: Visible in Playground">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/testquery.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=dd73bcc9eea009a895cf799701299daa" alt="Param Visible to User" width="2000" height="1066" data-path="images_new/agentsconsole/settings/testquery.png" />
</Frame>

***

## 🎯 Semantic Search Similarity

Control how precisely the agent matches your knowledge base.

### Relevance Thresholds

* `≥ 0.2`: Broad, flexible match
* `≥ 0.5`: Moderate contextual relevance
* `≥ 0.7`: Strict precision

Change it under **Agent Settings** with a simple dropdown.

<Frame caption="Semantic Scoring: Changing the Match Threshold">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/similarityscore.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=1b5ad682b7d2aa54fa07f2120a86f156" alt="Semantic Score Slider" width="2000" height="1066" data-path="images_new/agentsconsole/settings/similarityscore.png" />
</Frame>

***

## 📩 Lead Collection

You can now enable lead collection directly from the **Settings** panel.

### How it Works

* When **Enable Lead Collection** is turned on, a contact form will be shown inside the agent widget.
* This form gathers user information like name, email, and optional notes.
* It helps convert casual visitors into potential leads or customers.

<Frame caption="Settings: Lead Collection Toggle">
  <img src="https://mintcdn.com/aptlytechnologies/Oomvhw_D5bjA43Sl/images_new/agentsconsole/settings/collectleads.png?fit=max&auto=format&n=Oomvhw_D5bjA43Sl&q=85&s=a3e4cf0a7fc1d894e0523b86cc4ac5be" alt="Lead Collection Toggle" width="2000" height="1066" data-path="images_new/agentsconsole/settings/collectleads.png" />
</Frame>

<Note>
  Lead collection is a powerful way to capture qualified interest and convert chat interactions into actionable sales or support opportunities.
</Note>

For more details about CRM integration and how collected leads sync with **HubSpot**, visit the [Lead Collection page](/ai-bots-console/leads).

<Check>
  Configure these settings thoughtfully to ensure your agent delivers helpful, relevant, and contextually aware responses every time.
</Check>
