Mengelola alur kerja agentic Anda

Halaman pengguna Kelola Alur Kerja adalah tempat Anda dapat mengelola dan melihat informasi tentang alur kerja agentik Analisis Percakapan yang aktif dan tidak aktif yang telah Anda buat atau yang Anda tambahkan sebagai penerima.

Untuk membuka halaman pengguna Kelola Alur Kerja, pilih menu Profil, lalu pilih Alur Kerja. Halaman ini muncul di menu profil Anda hanya jika admin Looker telah memberi Anda izin chat_with_agent dan izin see_schedules atau izin create_alerts.

Informasi alur kerja

Halaman pengguna Kelola Alur Kerja memberikan informasi tentang alur kerja yang Anda miliki atau yang Anda daftarkan sebagai penerima. Bergantung pada waktu Anda membuat alur kerja, informasi ditampilkan di tab Alur Kerja atau tab Alur Kerja Lama.

Workflows

Tab Workflows menampilkan Agentic Workflows aktif dan nonaktif yang dibuat di Looker 26.14 atau yang lebih baru.

Kolom Definisi
Alur kerja Judul alur kerja, yang ditetapkan oleh agen saat alur kerja dimulai. Agen membuat judul alur kerja default berdasarkan konten percakapan. Klik nama alur kerja untuk membuka halaman Detail untuk alur kerja tersebut.
Agen Data Jika sumber data yang terkait dengan alur kerja adalah agen data, nama agen yang membuat alur kerja.
Pemilik Nama pengguna yang membuat alur kerja.
Tujuan Tujuan pengiriman notifikasi alur kerja. Opsinya adalah email atau Slack.
Frekuensi Frekuensi alur kerja dijalankan.
Menu opsi Menu yang dapat Anda gunakan untuk melakukan tindakan tambahan pada alur kerja. Lihat selengkapnya di bagian Opsi pengelolaan alur kerja di halaman ini.

Alur Kerja Lama

Kolom Definisi
Nama Alur Kerja Judul alur kerja, yang ditetapkan oleh agen saat alur kerja dimulai. Agen membuat judul alur kerja default berdasarkan konten percakapan. Klik nama alur kerja untuk membuka halaman Detail untuk alur kerja tersebut.
Pemilik Nama pengguna yang membuat alur kerja.
Waktu Proses Rata-Rata Durasi kueri alur kerja dalam detik.
Kondisi Terpenuhi Ya atau Tidak yang menunjukkan apakah kondisi alur kerja terpenuhi saat kueri alur kerja terakhir dijalankan. Simbol -- ditampilkan jika kueri alur kerja belum dijalankan atau jika kueri alur kerja dijalankan, tetapi tidak dapat ditentukan apakah kondisi alur kerja terpenuhi. Kolom ini menampilkan ikon peringatan atau ikon error yang terkait dengan peringatan atau error yang muncul saat kueri alur kerja dijalankan atau notifikasi alur kerja dikirimkan. Tahan kursor di atas ikon peringatan atau error untuk melihat pesan error terkait, jika ada.

Ikon peringatan dengan peringatan alur kerja yang tidak aktif menunjukkan bahwa data di kartu dasbor tidak berubah di antara dua kueri alur kerja terbaru. Baca selengkapnya tentang pesan ini di bagian Pesan error dan peringatan pemberitahuan di halaman ini.
Frekuensi Frekuensi alur kerja dijalankan untuk memeriksa apakah kondisi telah terpenuhi atau terlampaui.
Status Kolom ini menunjukkan apakah alur kerja aktif atau dinonaktifkan.

Alur kerja ditandai sebagai Dinonaktifkan saat pengguna menonaktifkan alur kerjanya sendiri dari halaman pengguna atau saat admin Looker menonaktifkan alur kerja. Menonaktifkan alur kerja akan menjeda notifikasi untuk penerima alur kerja mana pun.
Aktivitas Link yang mengarahkan Anda ke halaman Aktivitas alur kerja.
Menu opsi Menu yang dapat Anda gunakan untuk melakukan tindakan tambahan pada alur kerja. Lihat selengkapnya di bagian Mengelola alur kerja untuk instance Looker di halaman ini.

Mengelola alur kerja untuk instance Looker

Pengelolaan alur kerja dapat melibatkan tugas berikut:

Sejajar dengan setiap alur kerja adalah menu Opsi dengan pilihan berikut:

Workflows

  • Edit Alur Kerja
  • Histori
  • Hapus

Klik Edit Alur Kerja untuk membuka dan mengubah setelan alur kerja. Klik Simpan Alur Kerja untuk menyimpan perubahan atau Batal untuk menutup jendela pengeditan tanpa menyimpan.

Klik Histori untuk membuka halaman Eksekusi Alur Kerja dengan histori untuk alur kerja yang dipilih.

Klik Hapus untuk menghapus alur kerja. Jika Anda memilih untuk menghapus alur kerja, Anda akan diminta untuk mengonfirmasi pilihan Anda.

Alur Kerja Lama

  • Lihat Alur Kerja
  • Edit Alur Kerja
  • Nonaktifkan Alur Kerja (jika alur kerja aktif)
  • Aktifkan Alur Kerja (jika alur kerja dinonaktifkan)

Klik Lihat Alur Kerja untuk membuka halaman Detail.

Klik Edit Alur Kerja untuk membuka dan mengubah setelan alur kerja. Klik Simpan Alur Kerja untuk menyimpan perubahan atau Batal untuk menutup jendela pengeditan tanpa menyimpan.

Mengelola status alur kerja

Meskipun tidak dapat menghapus alur kerja secara permanen, Anda dapat mengontrol apakah alur kerja aktif atau tidak. Jika Status alur kerja adalah Aktif, kueri alur kerja akan terus berjalan sesuai dengan frekuensi yang ditentukan dalam alur kerja untuk memeriksa apakah kondisinya telah terpenuhi. Jika kondisi telah terpenuhi, penerima alur kerja akan diberi tahu dengan metode notifikasi yang ditentukan dalam alur kerja. Jika Status alur kerja adalah Dinonaktifkan, tidak ada kueri alur kerja yang akan berjalan dan tidak ada notifikasi yang akan dikirim. Halaman Detail alur kerja yang dinonaktifkan tidak menampilkan hasil dalam visualisasi alur kerja.

Pemilik alur kerja atau admin Looker mungkin perlu menonaktifkan alur kerja secara manual dalam beberapa keadaan, yang dapat mencakup hal berikut:

  • Menjeda notifikasi alur kerja untuk sementara guna mengonfigurasi ulang kondisi alur kerja
  • Memecahkan masalah pesan error atau peringatan
  • Mengatasi kegagalan pengiriman notifikasi

Untuk menonaktifkan alur kerja, ikuti langkah-langkah berikut:

  1. Di halaman pengguna Kelola Alur Kerja, temukan alur kerja yang perlu dinonaktifkan.
  2. Pilih menu Opsi alur kerja.
  3. Pilih Nonaktifkan Alur Kerja.

Anda dapat mengaktifkan kembali alur kerja kapan saja dengan mengikuti langkah-langkah berikut dan memilih Aktifkan Alur Kerja.

Melihat detail alur kerja

Halaman Detail menampilkan ringkasan setelan dan konfigurasi alur kerja. Informasi yang ditampilkan bergantung pada apakah alur kerja dibuat di Looker 26.14 atau yang lebih baru (tab Alur Kerja) atau sebelum 26.14 (tab Alur Kerja Lama).

Workflows

Saat memilih Lihat Alur Kerja dari menu Opsi atau mengklik nama alur kerja di tab Alur Kerja, Anda dapat melihat dan mengedit setelan konfigurasi alur kerja berikut:

  • Sumber data: Sumber data pokok untuk alur kerja, baik Agen (agen data) atau Eksplorasi tertentu (seperti purchases).
  • Alur Kerja: Nama alur kerja.
  • Pemicu: Jadwal atau kondisi yang memulai alur kerja:
    • Ulangi: Frekuensi eksekusi (seperti Menit, Per jam, Harian, Mingguan, atau Bulanan).
    • Hari: Hari dalam minggu atau bulan saat alur kerja dijalankan.
    • Waktu: Waktu tertentu dalam satu hari saat alur kerja berjalan.
  • Petunjuk: Petunjuk dan instruksi bahasa alami langkah demi langkah yang dijalankan agen selama setiap proses alur kerja.
  • Tujuan: Opsi pengiriman untuk hasil eksekusi alur kerja. Setiap eksekusi akan membuat percakapan baru yang dapat dilihat di Analisis Percakapan. Opsi pengiriman tambahan meliputi:
    • Email: Mengirimkan ringkasan narasi bahasa alami, tabel data, dan laporan PDF ke penerima email yang ditentukan.
    • Slack: Mengirimkan ringkasan naratif, blok data, dan laporan PDF ke saluran Slack atau pesan langsung yang ditentukan.
    • Daftar penerima: Tambahkan atau hapus alamat email penerima atau tujuan Slack satu per satu.

Klik Simpan perubahan untuk menyimpan modifikasi pada konfigurasi alur kerja.

Alur Kerja Lama

Saat Anda memilih alur kerja di tab Alur Kerja Lama, halaman Detail akan menampilkan informasi jadwal dan pemberitahuan lama:

  • Konteks tentang kondisi yang memicu alur kerja atau arti pemicuan alur kerja.
  • Visualisasi hasil kueri alur kerja.
  • Menu Lainnya pada visualisasi alur kerja, yang memiliki opsi Jelajahi dari sini. Pilih opsi ini untuk membuka Eksplorasi yang telah disetel sebelumnya dengan kueri alur kerja.
  • Tombol Uji Sekarang, yang menjalankan kueri alur kerja instan.

Dari halaman pengguna Kelola Alur Kerja, Anda dapat melihat halaman Detail untuk alur kerja yang Anda miliki atau yang Anda terima dengan salah satu cara berikut:

  1. Pilih menu Opsi alur kerja, lalu pilih Lihat Alur Kerja.
  2. Klik nama alur kerja.

Di halaman Detail, Anda dapat melakukan tugas berikut:

  1. Pilih kolom teks untuk menambahkan konteks tentang alur kerja.
  2. Pilih menu Lainnya, lalu pilih opsi Jelajahi dari sini untuk membuka Eksplorasi yang telah disetel sebelumnya dengan kueri alur kerja.
  3. Pilih Uji Sekarang untuk menjalankan kueri alur kerja secara instan, tanpa harus menunggu frekuensi yang ditentukan alur kerja. Jika kondisi alur kerja terpenuhi, notifikasi akan dikirim ke pemiliknya dan penerima tambahan.

Klik Selesai untuk menutup halaman Detail.

Memantau aktivitas alur kerja

Mengakses histori alur kerja memberikan beberapa keuntungan utama:

  • Verifikasi keberhasilan eksekusi dan pengiriman:
    • Konfirmasi apakah eksekusi terjadwal atau pemeriksaan nilai minimum terjadi tepat waktu.
    • Lihat status setiap eksekusi (Selesai, Berjalan, atau Error / Gagal).
    • Verifikasi metode pengiriman dan konfirmasi bahwa notifikasi mencapai tujuan yang dimaksud (Email atau Slack).
  • Mendiagnosis dan memecahkan masalah error:
    • Periksa pesan error mendetail untuk menyelesaikan masalah seperti:
    • Izin pengguna tidak ada (akses model).
    • Agen data yang dihapus atau Eksplorasi yang tidak dapat diakses.
    • Domain email eksternal atau saluran Slack yang tidak sah.
    • Timeout koneksi terputus-putus atau penundaan penghapusan antrean.
  • Kondisi pemicu audit dan keaktualan data:
    • Pemeriksaan kondisi: Lihat apakah kondisi nilai minimum terpenuhi atau terlampaui selama setiap proses evaluasi.
    • Keaktualan data: Mengidentifikasi apakah data database pokok telah berubah di antara eksekusi (Aktual: Ya atau Tidak), sehingga membantu mencegah atau mendiagnosis pemberitahuan alur kerja yang tidak aktual.
  • Pemantauan performa:
    • Lacak durasi runtime kueri dari waktu ke waktu untuk mengidentifikasi penurunan performa, kueri yang berjalan lambat, atau bottleneck database.
  • Auditabilitas dan kepatuhan:
    • Pertahankan catatan yang jelas tentang pengiriman laporan otomatis, daftar penerima, dan log eksekusi di seluruh tim atau instance Looker Anda.

Looker menjalankan kueri alur kerja pada frekuensi yang ditentukan. Untuk alur kerja yang dipicu, alur kerja ini memeriksa apakah kondisinya telah terpenuhi. Hasil pemeriksaan ini menjadi histori alur kerja. Untuk alur kerja lama, histori ini dapat dilihat di halaman Aktivitas. Untuk alur kerja, histori ini dapat dilihat di halaman Eksekusi Alur Kerja di panel admin. Looker menjalankan kueri alur kerja pada frekuensi yang ditentukan. Untuk alur kerja yang dipicu, alur kerja ini memeriksa apakah kondisinya telah terpenuhi. Hasil pemeriksaan ini menjadi histori alur kerja. Untuk alur kerja lama, histori ini dapat dilihat di halaman Aktivitas. Untuk alur kerja, histori ini dapat dilihat di halaman Eksekusi Alur Kerja di panel admin.

Workflows

Anda dapat mengakses halaman Eksekusi Alur Kerja dari halaman pengguna Kelola Alur Kerja dengan memilih opsi Histori dari menu Opsi. Untuk melihat halaman Eksekusi Alur Kerja, Anda harus diberi peran yang berisi izin see_schedules.

Alur Kerja Lama

Untuk alur kerja lama, tabel di halaman Aktivitas menyertakan informasi berikut tentang setiap tugas kueri alur kerja:

Judul Definisi Nilai yang memungkinkan
Berjalan Pada Stempel waktu saat kueri alur kerja dimulai Stempel waktu apa pun dalam format DD/MM HH:MM

Contoh: 05/30 18:25
Waktu Proses Durasi kueri alur kerja dijalankan Durasi apa pun dalam format 0.81s
Baru Boolean yang menunjukkan apakah kueri alur kerja memeriksa data yang telah berubah di antara dua kueri alur kerja terbaru
  • Yes (jika data berubah)
  • No (jika data tidak berubah)
Source Asal data yang digunakan kueri alur kerja untuk memeriksa nilai minimum yang ditunjukkan dalam kondisi alur kerja
  • query
  • cache
  • stale cache
  • Jika query, cache, atau stale cache tidak berlaku, nilai Sumber akan kosong.
Waktu Sumber Stempel waktu baris database yang digunakan kueri alur kerja untuk memeriksa nilai minimum Stempel waktu apa pun dalam format DD/MM HH:MM

Contoh: 05/25 16:01
Kondisi Terpenuhi Boolean yang menunjukkan apakah kondisi alur kerja terpenuhi atau tidak
  • Yes (kondisi terpenuhi)
  • No (kondisi tidak terpenuhi)
Pemicu: Nilai batas yang akan memicu alur kerja jika terpenuhi atau terlampaui Nilai numerik apa pun
Teramati Nilai yang diamati yang memenuhi atau melampaui kondisi alur kerja dan memicu alur kerja Nilai numerik apa pun
Status Status kueri alur kerja
  • Complete
  • Running
  • Not Started

Di halaman Aktivitas, Anda dapat melakukan tugas berikut:

  1. Melihat frekuensi kueri alur kerja memeriksa kondisinya.
  2. Lihat histori alur kerja.
  3. Gunakan tombol Uji Sekarang untuk menjalankan kueri alur kerja instan. Jika alur kerja dipicu, notifikasi akan dikirim ke pemiliknya dan penerima tambahan.

Klik Selesai untuk menutup halaman Aktivitas.

Pesan error dan peringatan alur kerja

Halaman pengguna Kelola Alur Kerja menampilkan error atau peringatan yang muncul saat alur kerja dijalankan atau notifikasi alur kerja dikirimkan. Pesan error, jika ada, akan muncul saat Anda mengarahkan kursor ke ikon peringatan atau ikon error di kolom Kondisi Terpenuhi.

Pengiriman notifikasi gagal dengan konfigurasi yang ada

Untuk alur kerja yang disiapkan untuk mengirimkan notifikasi ke Slack atau aplikasi seluler Looker, pesan error Notification delivery failed with existing configuration akan muncul saat alur kerja menentukan bahwa kondisi alur kerja telah terpenuhi, tetapi notifikasi tidak dapat dikirim. Kegagalan ini dapat terjadi jika ada perubahan pada konfigurasi Slack sejak alur kerja dibuat — misalnya, jika ruang kerja Slack yang menjadi tujuan pengiriman alur kerja tidak terhubung dari instance Looker, jika channel Slack yang menjadi tujuan pengiriman alur kerja dihapus, atau jika Looker tidak dapat terhubung ke integrasi.

Peringatan: Membuat kueri data baru

Ikon peringatan di kolom Kondisi Terpenuhi menunjukkan bahwa data yang menjadi dasar alur kerja tidak berubah di antara dua kueri alur kerja terbaru. Jika Anda mengarahkan kursor ke ikon ini, pesan Peringatan Pemberitahuan Usang akan ditampilkan.

Ada beberapa kemungkinan penjelasan mengapa data tidak berubah di antara kueri. Jika peringatan ini terus muncul, hubungi developer Looker Anda untuk memverifikasi bahwa kebijakan caching yang ditentukan untuk Eksplorasi agen selaras dengan setelan frekuensi alur kerja.

Mengubah kondisi alur kerja

Pemilik alur kerja atau admin Looker mungkin perlu mengubah konfigurasi alur kerja secara manual dalam beberapa keadaan, yang dapat mencakup hal berikut:

  • Mengaktifkan atau menonaktifkan Analisis faktor utama yang didukung Gemini, yang muncul di notifikasi
  • Menyesuaikan kondisi dan nilai minimum metrik yang memicu alur kerja seiring berkembangnya kebutuhan organisasi
  • Memperbarui tujuan notifikasi
  • Memperbarui frekuensi alur kerja agar lebih selaras dengan kebijakan caching

Untuk mengubah setelan alur kerja, ikuti langkah-langkah berikut:

  1. Dari halaman pengguna Kelola Alur Kerja, pilih menu Opsi untuk alur kerja yang ingin Anda ubah.
  2. Pilih Edit Alur Kerja, yang akan membuka dialog pengeditan alur kerja.
  3. Lakukan perubahan pada setelan alur kerja.
  4. Untuk alur kerja lama, pilih Simpan Pemberitahuan untuk menyimpan perubahan Anda. Untuk alur kerja, pilih Simpan perubahan untuk menyimpan perubahan Anda.

Efek menghapus agen, percakapan, Eksplorasi, atau dasbor pada alur kerja

Menghapus agen data atau percakapan akan memengaruhi alur kerja terkait dengan cara berikut:

  • Jika pengguna menghapus percakapan dengan agen yang membuat alur kerja, alur kerja tersebut akan tetap aktif. Penerima notifikasi alur kerja akan terus menerima notifikasi saat kondisi alur kerja terpenuhi.
  • Jika pengguna menghapus agen yang menghasilkan alur kerja, alur kerja tersebut akan tetap aktif. Penerima notifikasi alur kerja akan terus menerima notifikasi saat kondisi alur kerja terpenuhi.
  • Jika pengguna menghapus Eksplorasi atau dasbor yang berisi data yang dipantau alur kerja, alur kerja tersebut akan tetap aktif. Penerima notifikasi alur kerja akan terus menerima notifikasi saat kondisi alur kerja terpenuhi.