> For the complete documentation index, see [llms.txt](https://docs.omnix.co.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnix.co.id/omnix-ai/user-guide/create-ai-agent.md).

# Create AI Agent

Bangun AI Agent dengan mengatur prompt, knowledge base, guardrail, dan model LLM, lalu uji langsung sebelum digunakan.

{% hint style="info" %}
Siapkan **Knowledge Base** dan **Guardrail Policy** terlebih dahulu, karena keduanya dipilih di dalam form ini.
{% endhint %}

### Prompt Engine

1. Akses menu **AI Agent**.
2. Expand **Prompt Engine**, lalu definisikan role dan behavior AI Agent melalui field **Prompt**:
   * Role / peran AI Agent
   * Detail instruksi
   * Tone of voice

Anda juga dapat memilih **Template Prompt**, lalu klik **Insert to Agent Role and Instructions** untuk memakai template yang tersedia.

<figure><img src="https://1873476608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr2cl4HgiZ8c57Ur5nrwn%2Fuploads%2FlJM4uq5aSSl79cdPh8kv%2Fagent-prompt-engine.jpg?alt=media&amp;token=3f1bbe98-c730-487e-ba23-cba08176cece" alt=""><figcaption><p>Prompt Engine</p></figcaption></figure>

### Agent AI Settings

3. Expand **Agent AI Settings**.
4. Search dan pilih **Knowledgebase** yang relevan sebagai acuan AI Agent menjawab pertanyaan.
5. Search dan pilih **Safe Guard Policy** sebagai batasan dan aturan AI Agent dalam menjawab.
6. Centang **Allowed Attachment** agar user dapat mengirim file. Kosongkan jika user hanya diizinkan untuk percakapan teks.

<figure><img src="https://1873476608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr2cl4HgiZ8c57Ur5nrwn%2Fuploads%2Fi2qlx4niv4gacosqSbSb%2Fagent-ai-settings.jpg?alt=media&amp;token=5c985a24-06d9-42b4-bad4-ee350da00e20" alt=""><figcaption><p>Agent AI Settings</p></figcaption></figure>

### Model Settings

7. Expand **Model Settings**.
8. Pilih **Model** LLM sesuai kebutuhan dari dropdown yang tersedia.
9. Klik ikon pengaturan untuk menyesuaikan parameter **LLM** dan **Retrieval**.

| Tab       | Parameter     | Rentang  | Fungsi                                                                                       |
| --------- | ------------- | -------- | -------------------------------------------------------------------------------------------- |
| LLM       | Temperature   | 0 – 1    | Mengatur tingkat variasi (randomness) jawaban. Nilai rendah membuat jawaban lebih konsisten. |
| LLM       | Top P         | 0 – 1    | Membatasi sampling hanya pada token dengan probabilitas tertinggi.                           |
| Retrieval | Vector Rerank | On / Off | Mengurutkan ulang hasil retrieval berdasarkan relevansi semantik.                            |
| Retrieval | Top K         | 0 – 10   | Membatasi jumlah hasil retrieval yang digunakan AI Agent.                                    |

<figure><img src="https://1873476608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr2cl4HgiZ8c57Ur5nrwn%2Fuploads%2Fk0xHSxtSf4OWwY4lICz8%2Fagent-model-settings.jpg?alt=media&amp;token=82f3c30b-5781-41d2-98a2-704c61c9294e" alt=""><figcaption><p>Model Settings</p></figcaption></figure>

### Preview & Detail

* **Preview** digunakan untuk menguji AI Agent dan memastikan respons sudah sesuai dengan Prompt, Knowledge Base, Guardrail, dan Model Settings.
* **Detail** menampilkan reasoning dan data hasil retrieval (dokumen KB, chunk, dan score) dari setiap jawaban.

<figure><img src="https://1873476608-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr2cl4HgiZ8c57Ur5nrwn%2Fuploads%2F8OshWxqyepPiyrLRh6vz%2Fagent-preview-detail.jpg?alt=media&amp;token=1b710875-0191-4f4e-af0d-e462f77f9134" alt=""><figcaption><p>Preview &#x26; Detail</p></figcaption></figure>

Setelah hasil pengujian sesuai, klik **Save** untuk menyimpan AI Agent.