# Eksekusi

Setiap kali alur kerja memproses pesan pelanggan, tumbuh.ai mencatatnya sebagai satu **eksekusi**. Menu **Eksekusi** adalah tempat Anda melihat catatan itu, dari ringkasan per percakapan sampai trace tiap langkah. Gunakan untuk memahami kenapa AI membalas, tidak membalas, atau gagal.

Menu ini ada di **AI Automation** lalu **Eksekusi**. Hanya Pemilik bisnis dan Admin yang bisa membukanya.

## Sebelum mulai

- Ada [alur kerja](/ai-automation/alur-kerja) yang sudah diterbitkan dan sudah menerima pesan, atau Anda sudah mencoba lewat [Playground](/ai-automation/playground).
- Eksekusi hanya dibaca di halaman ini. Tidak ada tombol untuk menjalankan ulang atau mengubah hasilnya.

## Halaman Workspace trace percakapan

Halaman utama mengelompokkan eksekusi **per percakapan**. Tata letaknya:

- Bagian atas: **Pencarian dan filter** dan ringkasan **Safety**.
- Kiri, panel **Percakapan**: daftar percakapan yang cocok dengan filter. Tiap baris menampilkan nama pelanggan atau identitas percakapan, kanal, status utama, jumlah eksekusi, dan jumlah sinyal safety bila ada.
- Kanan: **Timeline eksekusi** untuk percakapan terpilih, dan **Trace inline** untuk eksekusi terpilih.

Daftar percakapan dipecah per halaman (tombol **Sebelumnya** dan **Berikutnya**). Timeline menampilkan eksekusi terbaru percakapan itu, beberapa per halaman. Bila ada eksekusi yang lebih lama dari yang dimuat, halaman menyebutnya dan Anda dapat memakai filter atau membuka detail trace.

Saat halaman dibuka, percakapan dan eksekusi pertama otomatis terpilih.

## Memfilter eksekusi

Kartu **Pencarian dan filter** memiliki:

| Filter | Pilihan |
|---|---|
| **Workflow** | **Semua workflow** atau salah satu alur kerja Anda |
| **Status** | Lihat tabel status di bawah |
| **Kanal** | **Semua kanal**, WhatsApp, Instagram, Messenger, Telegram, atau Web |
| **Percakapan** | Isi ID percakapan yang tepat, atau pilih dari daftar **Pilih percakapan** |
| **Dari** dan **Sampai** | Rentang tanggal (hari awal sampai akhir hari) |

Filter ikut tersimpan di alamat halaman, jadi Anda bisa membagikan tautan tampilan yang sama kepada rekan. **Hapus semua** mengosongkan filter.

Untuk melihat satu alur kerja saja, pilih alurnya di filter **Workflow**. Panel **Percakapan** dan ringkasan safety langsung mengikuti pilihan itu.

> Halaman ini hanya memuat hingga 20 eksekusi terbaru per percakapan. Untuk kasus yang lebih lama, persempit dengan **Dari** dan **Sampai**.

## Arti status

| Status | Artinya |
|---|---|
| **Tertunda** | Eksekusi sudah dibuat dan menunggu giliran diproses |
| **Berjalan** | Sedang diproses |
| **Menunggu** | Menunggu untuk dicoba lagi (misalnya setelah kegagalan sementara). Detail menunjukkan jumlah percobaan dan waktu coba ulang berikutnya |
| **Selesai** | Alur kerja menangani pesan dan menyelesaikan prosesnya |
| **Tidak ditangani** | Alur kerja berjalan tetapi tidak menghasilkan penanganan atas pesan itu (tidak ada balasan yang dianggap menangani) |
| **Handoff** | Percakapan dialihkan ke tim, lihat [Handoff](/ai-automation/handoff) |
| **Dilewati (manusia aktif)** | AI tidak memproses karena percakapan sedang dipegang agen manusia |
| **Gagal** | Terjadi galat dan proses berhenti |
| **Dibatalkan** | Eksekusi dibatalkan |

Status di panel **Percakapan** adalah status paling penting dari eksekusi di percakapan itu. Urutan prioritasnya: Gagal, Menunggu, Berjalan, Tertunda, Handoff, Tidak ditangani, Dilewati, Dibatalkan, lalu Selesai.

Eksekusi yang masih berjalan, tertunda, atau menunggu diperbarui otomatis. Setelah selesai, pembaruan berhenti.

## Ringkasan Safety

Bila alur kerja mendeteksi pesan yang perlu perhatian, jumlahnya muncul di ringkasan **Safety**: **Sinyal safety**, **Eksekusi dengan safety**, **Diblokir**, dan **Review**. Angkanya mencakup semua eksekusi yang cocok dengan filter aktif.

## Membuka detail eksekusi

Pada panel kanan, klik **Buka trace** untuk membuka halaman detail satu eksekusi. Isinya:

- Judul **Eksekusi** dengan ID, tombol **Kembali ke eksekusi**, **Buka workflow**, dan **Link percakapan** (membuka percakapan di inbox).
- Metadata: workflow, versi yang berjalan, status, waktu dibuat, durasi, kanal, tipe percakapan, pelanggan, jumlah percobaan, langkah saat ini, dan lain-lain.
- Kartu **Eksekusi gagal** bila ada galat, dengan baris trace pertama yang gagal ditampilkan di depan.
- **Trace viewer** dengan filter **Semua**, **Error**, **Agent**, dan **Safety**.
- **Diagnostik**: **Salin snapshot** atau **Unduh snapshot** (data sudah disamarkan) dan **Buka debug workflow**.

Menjalankan uji lewat debug workflow bisa membuat catatan nyata. Gunakan data uji, jangan dari detail eksekusi historis sembarangan.

## Membaca trace

Trace adalah daftar **langkah** yang dilalui alur kerja. Tiap baris menampilkan nomor langkah, node, jenis event, status, dan latensi. Buka satu baris untuk melihat:

- **Input tersamarkan** dan **Output tersamarkan**: data yang masuk dan keluar dari node. Nilai sensitif disamarkan.
- **Error**: pesan dan kode galat bila langkah gagal.
- **Metadata**.

Untuk node **AI Agent**, trace juga merangkum jumlah keputusan, panggilan tool, dan kegagalan, serta hasil tiap aksi yang dipakai agent untuk keputusan berikutnya.

## Tips debugging: "AI tidak menjawab"

1. Buka **Eksekusi**, isi **Percakapan** atau pilih percakapannya, lalu lihat status eksekusi terbaru.
2. Baca statusnya:
   - **Tidak ada eksekusi sama sekali**: alur kerja tidak terpicu. Pastikan alurnya sudah diterbitkan dan terpasang ke kanal itu di [Alur Kerja](/ai-automation/alur-kerja).
   - **Dilewati (manusia aktif)**: percakapan sedang dipegang agen. AI sengaja diam.
   - **Handoff**: percakapan sudah dialihkan ke tim, lihat [Handoff](/ai-automation/handoff).
   - **Tidak ditangani**: alur berjalan tetapi tidak sampai ke balasan. Telusuri trace untuk melihat cabang atau node yang dilewati.
   - **Gagal** atau **Menunggu**: buka detail dan baca kartu **Eksekusi gagal**, atau pakai filter **Error** di trace viewer.
3. Di trace, cari node **AI Agent** dan baca keputusannya. Periksa apakah tool pengetahuan atau [Integrasi Keluar](/ai-automation/integrasi-keluar) mengembalikan hasil kosong atau galat.
4. Cek **Safety**: pesan yang diblokir tidak dibalas.
5. Ulangi kasusnya di [Playground](/ai-automation/playground) setelah memperbaiki alur kerja, lalu terbitkan versi baru.

## Hasil yang diharapkan

Anda dapat menemukan eksekusi untuk satu percakapan, mengetahui statusnya, dan melihat langkah mana yang menentukan hasilnya.

## Masalah umum

- **Daftar kosong.** Hapus filter, atau perlebar rentang tanggal. Pesan "Tidak ada percakapan yang cocok dengan filter ini." berarti tidak ada eksekusi yang lolos filter.
- **Percakapan terpilih tidak terlihat di daftar.** Muncul "Percakapan terpilih berada di luar filter saat ini". Hapus filter atau pilih percakapan lain.
- **Baris trace kosong.** "Belum ada event trace untuk eksekusi ini." Eksekusi mungkin baru dimulai. Tunggu sebentar, halaman diperbarui otomatis.