AI Agent Studio

AI Agent Studio adalah antarmuka wizard yang memungkinkan pengguna untuk membuat dan mengkonfigurasi agen bertenaga AI dengan kemampuan canggih melalui proses panduan langkah demi langkah. Studio ini menyediakan UI yang intuitif dengan konfigurasi berbantuan AI untuk membangun System Agent (pemroses tugas otomatis) dan Chat Agent (asisten percakapan).

Memahami AI Agent Studio

Tujuan: AI Agent Studio memungkinkan pengguna untuk merancang, membuat, mengkonfigurasi, dan mengelola agen AI melalui antarmuka wizard terpandu. Ini menyederhanakan proses konfigurasi agen yang kompleks dengan menyediakan langkah-langkah terstruktur, penjelasan field inline, dan Asisten AI terintegrasi yang dapat menjawab pertanyaan atau mengusulkan perubahan konfigurasi.

Fungsi: Studio ini memungkinkan pengguna untuk: - Membuat System Agent yang melakukan tugas otomatis, memproses data, dan merespons pemicu sistem - Membuat Chat Agent yang berinteraksi secara percakapan dengan pengguna - Mengkonfigurasi konteks agen, tools, perilaku loop, aturan evaluasi, dan guardrail keamanan - Melihat pratinjau dan menguji konfigurasi agen secara real-time - Memanfaatkan bantuan AI untuk memahami field atau menghasilkan saran konfigurasi

Role yang Diperlukan

Untuk mengakses AI Agent Studio, pengguna harus memiliki salah satu role berikut: System Manager, Administrator, TM AI Developer, TM AI Chat Admin, dan TM AI Chat User.

Fitur AI Agent Studio

Fitur	Deskripsi
Pemilihan Tipe Agent	Pilih antara System Agent (otomatis) atau Chat Agent (percakapan)
Wizard Langkah demi Langkah	Proses konfigurasi terpandu dengan langkah dan penjelasan field yang jelas
Pengaturan Dasar	Konfigurasi nama agen, model AI, konteks aplikasi, dan status aktivasi
Konfigurasi Konteks	Definisikan instruksi agen, konteks tambahan, dan sumber pengetahuan
Integrasi Tools	Pilih tools yang dapat digunakan agen untuk melakukan tindakan
Konfigurasi Loop	Aktifkan perbaikan berulang dengan iterasi maksimum dan skills
Aturan Evaluasi	Atur penilaian kualitas otomatis untuk output agen
Guardrails	Konfigurasi aturan keamanan untuk menegakkan kebijakan dan kepatuhan
Konfigurasi Chat	Definisikan perilaku chat, instruksi, dan batas pesan (untuk Chat Agent)
Pengaturan Pengguna	Konfigurasi role yang diizinkan dan instruksi pengguna (untuk Chat Agent)
AI Assistant	Antarmuka chat terintegrasi dengan mode Ask dan Edit untuk membantu konfigurasi
Mode Draft	Buat dan uji agen sebelum menyimpan ke database
Mode Edit	Modifikasi agen yang ada dengan riwayat konfigurasi lengkap
Manajemen Avatar	Unggah dan konfigurasi avatar agen untuk antarmuka chat
Manajemen Session	Mempertahankan status konfigurasi selama sesi editing

Prosedur

1. Navigasi ke AI Agent Studio

• Buka modul TechMaju AI > halaman AI Agent Studio
• Atau akses langsung melalui URL: /app/ai-agent-studio

2. Pilih Tipe Agent

• Klik Create New Agent untuk memulai wizard
• Pilih tipe agent:
  • System Agent: Untuk tugas otomatis, pemrosesan data, dan integrasi sistem
  • Chat Agent: Untuk interaksi percakapan dengan pengguna
• Tinjau deskripsi dan klik Continue

3. Konfigurasi Pengaturan Dasar

Untuk System Agent: - Agent Name: Masukkan nama unik dan deskriptif - AI Model: Pilih model AI yang akan memberdayakan agen (difilter hanya model aktif) - Application: Tautan ke konteks aplikasi bisnis (opsional untuk agen non-sistem) - From Trigger: Aktifkan jika agen harus merespons event DocType - Trigger DocType: Pilih DocType mana yang memicu agen (wajib jika From Trigger diaktifkan) - Active: Aktifkan untuk mengaktifkan agen segera - System Generated: Menunjukkan jika agen dibuat otomatis (biasanya tidak dicentang untuk pembuatan manual)

Untuk Chat Agent: - Agent Name: Masukkan nama unik dan deskriptif - AI Model: Pilih model AI (LLM diperlukan untuk fitur evaluasi) - Short Description: Deskripsi singkat yang ditampilkan kepada pengguna - Application: Tautan ke aplikasi bisnis (tidak dapat diubah setelah pembuatan) - Active: Aktifkan untuk membuat agen tersedia bagi pengguna - Avatar Path: Unggah atau tentukan path ke gambar avatar agen

4. Definisikan Konteks (System Agent)

Agent Context: - Masukkan instruksi sistem yang mendefinisikan bagaimana agen harus berperilaku - Sediakan pengetahuan domain, panduan tugas, dan aturan perilaku

Additional Context: - Pilih dari set konteks yang tersedia untuk menyertakan informasi tambahan - Lampirkan file, URL, atau data kontekstual lainnya

Opsi Spesifik Model: - Untuk Vision Language Models (VLM): Unggah gambar untuk konteks visual - Untuk Model Generasi Gambar: Konfigurasi parameter generasi gambar - Untuk Model Generasi Video: Konfigurasi pengaturan generasi video

5. Konfigurasi Tools (System Agent)

• Pilih tools yang dapat digunakan agen untuk melakukan tindakan
• Contoh: Pencarian database, pengiriman email, pemrosesan dokumen
• Hanya pilih tools yang penting untuk tugas agen

6. Atur Konfigurasi Loop (System Agent)

• Enable Loop: Izinkan agen untuk memperbaiki outputnya secara berulang
• Max Iterations: Atur maksimum percobaan perbaikan (1-10, default: 3)
• Stop On Task Complete: Hentikan iterasi ketika agen menandai tugas selesai
• Skills: Pilih skills yang tersedia selama eksekusi loop untuk peningkatan kualitas

7. Konfigurasi Evaluasi (Opsional)

• Enable Eval: Aktifkan penilaian kualitas otomatis
• Evaluation Rules: Pilih aturan untuk menilai kualitas output
  • Catatan: Evaluasi hanya didukung untuk agen berbasis LLM
  • Kriteria dapat mencakup akurasi, kelengkapan, kepatuhan pada panduan

8. Atur Guardrails (Opsional)

• Enable Guard: Aktifkan guardrail keamanan dan kepatuhan
• Guard Rules: Konfigurasi aturan spesifik untuk:
  • Guard Rule: Pilih dari aturan guard yang tersedia
  • Enabled: Aktifkan/nonaktifkan aturan individual
  • Execution Stage: Atur kapan aturan berlaku (misalnya, input, output)
  • Action Override: Override tindakan default jika diperlukan
• Log guard akan ditampilkan setelah menyimpan agen

9. Konfigurasi Pengaturan Chat (Khusus Chat Agent)

Chat Configuration: - Instructions: Definisikan kepribadian agen dan gaya respons - Context: Pilih item konteks tambahan untuk percakapan - Max Chat Length: Atur maksimum pesan per session (default: 100)

User Settings: - Allowed Roles: Tentukan role yang dapat mengakses agen ini (kosongkan untuk semua pengguna Desk) - User Instructions: Berikan panduan tentang cara menggunakan agen dengan efektif

10. Gunakan AI Assistant (Opsional)

• Klik panel AI Assistant di sisi kanan
• Dua mode tersedia:
  • Ask Mode: Ajukan pertanyaan tentang konfigurasi agen, praktik terbaik, atau arti field
  • Edit Mode: Minta AI untuk mengusulkan perubahan konfigurasi spesifik
• Tinjau saran AI dan terapkan ke konfigurasi Anda

11. Simpan Agent

• Tinjau semua konfigurasi di semua langkah
• Klik Save Agent untuk membuat agen di database
• Agen akan diberi ID unik dan menjadi dapat diakses
• Untuk Chat Agent dengan status aktif, pengguna dengan role yang sesuai dapat langsung memulai percakapan

12. Edit Agent yang Ada

• Navigasi ke AI Agent Studio
• Pilih Edit Agent dan pilih agen yang akan dimodifikasi
• Konfigurasi dimuat dengan semua pengaturan saat ini
• Buat perubahan di langkah mana pun
• Klik Save Agent untuk memperbarui
• Semua perubahan dilacak dalam riwayat konfigurasi agen

Praktik Terbaik

• Mulai Sederhana: Mulai dengan konfigurasi dasar dan tambahkan fitur lanjutan secara bertahap
• Uji di Mode Draft: Gunakan mode draft untuk bereksperimen dengan konfigurasi sebelum menyimpan
• Gunakan Nama Deskriptif: Pilih nama agen yang dengan jelas menunjukkan tujuannya
• Pilih Model yang Sesuai: Sesuaikan kemampuan model AI dengan persyaratan agen
• Konfigurasi Guardrails: Selalu aktifkan guards untuk agen dengan akses tulis atau operasi sensitif
• Manfaatkan AI Assistant: Gunakan mode Ask untuk memahami field kompleks atau memvalidasi keputusan konfigurasi
• Tinjau Log Evaluasi: Periksa skor evaluasi secara berkala untuk memastikan kualitas agen
• Monitor Log Guard: Tinjau log guard untuk mengidentifikasi potensi masalah keamanan atau kepatuhan
• Atur Iterasi yang Sesuai: Untuk agen dengan loop diaktifkan, mulai dengan 3 iterasi dan sesuaikan berdasarkan kinerja
• Dokumentasikan Konteks: Berikan konteks yang jelas dan komprehensif untuk meningkatkan efektivitas agen
• Uji Sebelum Deployment: Uji agen secara menyeluruh di lingkungan pengembangan sebelum mengaktifkan di produksi
• Update Berkala: Tinjau dan perbarui konfigurasi agen secara berkala seiring berkembangnya persyaratan
• Akses Berbasis Role: Untuk Chat Agent, konfigurasikan allowed roles dengan hati-hati untuk menjaga keamanan
• Pemilihan Avatar: Pilih avatar yang sesuai untuk Chat Agent untuk meningkatkan pengalaman pengguna
• Linking Aplikasi: Tautkan agen ke aplikasi spesifik untuk organisasi dan kesadaran konteks yang lebih baik