# AI Assistant - Beta

## Overview

Maxchat telah release fitur AI yang dinamakan dengan Maxchat AI Assistant yang dapat menghubungkan platform Maxchat dengan GPT dan ke depannya akan dihubungkan dengan Maxchat AI yang dapat mengakomodir berbagai kebutuhan custom.

## Menambahkan AI Assistant Baru

Untuk saat ini, Maxchat hanya dapat terhubung ke satu AI Assistant dalam satu waktu sehingga hanya bisa ditambahkan ketika semua AI assistant yang pernah dibuat dalam keadaan disabled atau ketika sama sekali belum ada AI Assistant yang dibuat.

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

***

Pada form pembuatan AI Assistant baru, Anda akan menemui beberapa pengaturan dan kolom.

* Active Assistant: langsung mengaktifkan assistant ketika selesai dibuat.
* Fallback as agent: ketika AI Agent Default dari AI Assistant tersebut tidak dapat menjawab pertanyaan, maka chatroom akan diberikan kepada agen\
  \[tooltip]
* Name: nama AI Assistant
* Type: tipe AI yang digunakan. untuk saat ini yang tersedia adalah GPT
* Models: model dari tipe AI yang dapat digunakan.
* API Key:&#x20;
  * Anda dapat menggunakan API Key Anda sendiri atau dapat juga menggunakan API Key yang disediakan oleh Maxchat, silakan hubungi tim kami untuk pengaturan ini.

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

***

## AI Agents

pada AI Agents, Anda dapat membuat banyak Agent dengan prompt yang berbeda.

toggle pada AI Agent akan mengatur ketersediaan dari Agent tersebut.&#x20;

* Jika diaktifkan (ON), maka AI Agent tersebut akan aktif.
* Jika dimatikan (OFF), maka AI Agent tersebut tidak akan aktif.

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

Ketika Anda membuat Agent baru, Anda akan melihat pengaturan dan kolom sebagai berikut:

* Active Agent: akan langsung mengaktifkan agent setelah agen dibuat.
* Force Null: akan mengatur apakah AI Agent perlu membalas ketika AI agent tidak tahu.
  * Jika ON, maka AI Agent tidak akan membalas apapun jika AI agent tidak mengetahui jawabannya.
  * Jika OFF, maka AI Agent masih akan membalas sesuai dengan prompt jika AI agent tidak mengetahui jawabannya.
* Name: nama AI Agent
* Instruction: prompt atau perintah yang dapat Anda atur dan sesuaikan dengan kebutuhan AI Agent Anda. Anda dapat memberikan segala perintah kepada AI Agent, seperti memberikan instruksi peran apa yang sedang dijalankan oleh AI Agent, bagaimana cara menjawab, cara menanggapi pertanyaan yang tidak diketahui, dan lain sebagainya.
* Temperature: adalah tingkat kreatifitas dari AI Agent.&#x20;

{% hint style="info" %}
Namun jika tingkat kekreatifan dari AI Agent terlalu tinggi, dapat menyebabkan hasil jawaban yang kurang sesuai.

Temperature yang disarankan adalah 0.3 hingga 0.4
{% endhint %}

* <mark style="background-color:red;">Message Type:</mark>
  * <mark style="background-color:red;">Text:</mark>
  * <mark style="background-color:red;">Info:</mark>
* <mark style="background-color:red;">Response Format:</mark>
  * <mark style="background-color:red;">Auto:</mark>
  * <mark style="background-color:red;">Text:</mark>
  * <mark style="background-color:red;">JSON Object:</mark>
* File Search: sumber atau data bank yang akan digunakan oleh AI Agent sebagai pedoman dalam menjawab pertanyaan pelanggan.

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

***

Files adalah data bank atau sumber data yang akan digunakan oleh AI Agent dalam menjawab pertanyaan pelanggan.&#x20;

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

<mark style="background-color:red;">Anda hanya dapat melakukan upload file ber-ekstensi (.pdf). Ukuran file maksimal yang dapat Anda unggah adalah</mark>

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

***

<mark style="background-color:red;">Vector</mark>

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

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


---

# 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://maxchat.gitbook.io/v3/integration/chatbot/ai-assistant-beta.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.