# Assistants

<figure><img src="https://lh7-us.googleusercontent.com/slidesz/AGV_vUdhUPyRkOw7qttuz2FP5lSESzvoxIMpQnZetLxX_LGgMgc4NXHorI7p5acNzWSkJg0EOCx_gMuBdIVs_7xqCTqULyA3Aj5wPvSpyjqfp1KwyfhQqOIN0HwGOc1UO6uCaD1SuyCl8e9jDT9L4cwqP2ZeVZTjfZZz=s2048?key=0Vuv-rJx-rGDStWDzAwBDw" alt=""><figcaption><p>Assistant page</p></figcaption></figure>

## Create an assistant

The Assistant detail consists of these fields separated into 5 section, which are

<figure><img src="/files/AWyvpdVVdtckDkzHOcr0" alt=""><figcaption><p>Create an assistant page</p></figcaption></figure>

### Assistant Setting

* **Assistant Name:** Limit the text type to a maximum of 255 characters.
* **Prompt:** Input your custom prompt instructions here. If you need some inspiration, we have a prompt library you can browse to see if something there might suit your needs.
* **Type:** BOTs+ currently only supports Questions & Answers.
* **Question Input Source:** Choose between generating answers based on the original question or a translated version into English.
* **Greeting Message (optional):** *This setting only applies to the ASAP sandbox.* Show a pre-defined greeting message when a user starts a new session or opens the chat. This will not get sent out to external channels.&#x20;
* **Style**: Pick the temperature of the response from the LLM. Precise (temp = 0.2) causes the LLM to respond in more consistent ways based on the provided context. Create (temp = 0.8) causes the LLM to respond in more diverse and creative ways, while still referencing the provided context.&#x20;
* **Session Reset Timer**: When set to 0, this function is never time out. When a value is selected (1 - 12), the user's session will soft reset if no message is sent to BOT+ during that time period.&#x20;

### Search & Fulfillments

* **Fulfillments (optional):** Connect a fulfillment to attach to your assistant. BOTs+ will search the documents attached to these fulfilment in order to find relevant documents to send to the LLM as part of the Prompt payload.

### Answer Generation

* **Model**: Pick your desired LLM. At the moment, BOTs+ only supports GPT-3.5 and GPT-4.
  * GPT-3.5 is suitable for most tasks however is weak when it comes to logic, pure creation, understanding of sciences, and handling of complex enquires.&#x20;
  * GPT-4 is a better choice for long and complex questions, as well as sentiment analysis, working with numbers, and connecting the dots on discrete pieces of information.&#x20;

### Validator

* **Enable Validation:** enable to select validation method which default to KM Confidence Threshold<br>

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

  * KM Confidence Threshold option will filter out all searched chunks that are lower than the set score.
  * If disable this field, it means to ignore the validation and utilize all searched chunk, or as setting 0% of  Confidence Threshold.

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

* **AI Goal Affirmation (optional):** A set of priority instructions that will be sent to the LLM. This is appended to the Prompt Payload towards the button, which tends to make the LLM give it a higher priority compared to the main Prompt Instructions.
* **Fallback Message:** Provide a fallback message when the assistant cannot generate an answer using fulfillments, limit to 500 characters.

### Integration

* **Event Webhook URL (optional):** Input your webhook URL for ASAP to send events to. ASAP only currently sends a session reset event.
* **Response URL  (optional):** If you are sending out to an external channel, please input the webhook URL here.


---

# 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.amitysolutions.com/amity-solutions/amity-bots-gen-ai-platform/assistants.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.
