Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menjalankan agen kustom
Anda dapat menjalankan agen kustom sesuai permintaan atau mengkonfigurasi pemicu untuk menjalankannya secara otomatis.
Menjalankan agen kustom sesuai permintaan
Anda dapat menjalankan agen khusus segera dari halaman detail agen atau melalui Obrolan.
Untuk menjalankan agen kustom dari halaman detail:
Arahkan ke halaman Agen di aplikasi web DevOps Agen Anda.
Pilih agen khusus yang ingin Anda jalankan.
Pilih Jalankan Sekarang untuk menjalankan agen dengan instruksi yang dikonfigurasi.
Untuk memberikan konteks tambahan untuk proses tertentu, pilih panah tarik-turun di sebelah Jalankan Sekarang, masukkan prompt yang menjelaskan apa yang harus difokuskan agen dalam pemanggilan ini, dan pilih J alankan dengan prompt. Prompt diteruskan ke agen sebagai konteks tambahan di samping prompt sistemnya.
Setelah proses dimulai, pemanggilan baru muncul di tab Ri wayat dengan status “Mulai tertunda”. Pilih pemanggilan untuk melihat lintasannya secara real time.
Untuk menjalankan agen khusus menggunakan Obrolan:
Minta Chat untuk menjalankan agen dengan nama. Contoh:
Run my weekly-investigation-report agent.
Run certificate-checker and focus on certificates expiring in the next 7 days.
Saat Anda memberikan konteks tambahan dalam pesan obrolan, Chat meneruskannya sebagai prompt untuk menjalankan itu. Jika Anda tidak memberikan konteks tambahan, agen akan berjalan dengan prompt sistem yang dikonfigurasi saja.
Agen kustom hanya dapat menjalankan satu pemanggilan pada satu waktu. Jika agen sudah berjalan, Anda harus menunggu pemanggilan saat ini selesai, habis waktu, atau dibatalkan sebelum memulai yang lain.
Mengkonfigurasi pemicu
Pemicu menjalankan agen kustom secara otomatis berdasarkan kondisi yang ditentukan. AWS DevOps Agen mendukung dua jenis pemicu:
Jadwal pemicu — Jalankan agen pada interval berulang menggunakan ekspresi EventBridge-compatible cron atau rate.
Pemicu peristiwa — Jalankan agen saat peristiwa webhook datang dari integrasi yang terhubung, meneruskan payload peristiwa sebagai konteks.
Kedua jenis pemicu dibuat dari tab Pem icu dari agen kustom. Untuk membukanya, buka halaman Agen di aplikasi web DevOps Agen Anda, pilih agen khusus, lalu pilih tab Pem icu.
Membuat pemicu jadwal
Ekspresi jadwal menggunakan sintaks EventBridge-compatible cron atau rate. Ekspresi harus berupa salah satu format berikut:
Ekspresi tingkat — Berjalan pada interval tetap. Format:
rate(value unit). Contoh:rate(1 hour)— Setiap jamrate(30 minutes)— Setiap 30 menitrate(7 days)— Setiap 7 hari
Ekspresi C ron — Berjalan pada jadwal tertentu. Format:
cron(minutes hours day-of-month month day-of-week year). Contoh:cron(0 9 ? * MON-FRI *)— Setiap hari kerja pukul 09:00 UTCcron(0 0 1 * ? *)— Hari pertama setiap bulan pada tengah malam UTCcron(0 */6 ? * * *)— Setiap 6 jam
Untuk ekspresi cron, tepatnya satu hari dalam bulan atau hari dalam seminggu harus ? (tanda tanya). Untuk informasi selengkapnya tentang sintaks ekspresi jadwal, lihat Jenis jadwal di Panduan Pengguna EventBridge Penjadwal Amazon.
Untuk membuat pemicu jadwal:
Pilih tombol + (buat).
Untuk Jenis Pemicu, pilih Jadwal.
Masukkan ekspresi jadwal. Pesan konfirmasi hijau muncul saat ekspresi valid.
(Opsional) Untuk memberikan konteks tambahan untuk setiap proses yang dijadwalkan, masukkan prompt di kolom Prompt pengguna (opsional). Prompt diteruskan ke agen bersama prompt sistemnya.
Pilih Buat.
Setelah pembuatan, pemicu muncul dalam daftar yang menunjukkan ekspresi, tanggal pembuatan, dan waktu berjalan terjadwal berikutnya.
Membuat pemicu acara
Pemicu peristiwa menjalankan agen kustom ketika peristiwa webhook datang dari integrasi yang terhubung. Muatan peristiwa diteruskan ke agen sebagai konteks untuk menjalankan itu.
Prasyarat:
Sebelum membuat pemicu peristiwa, Anda harus memiliki integrasi yang terhubung dengan webhook aktif di ruang agen Anda. Setiap integrasi dengan webhook aktif dapat berfungsi sebagai sumber acara. Untuk informasi selengkapnya tentang menyiapkan integrasi, lihatMemanggil A DevOps gen melalui Webhook.
Untuk membuat pemicu peristiwa:
Pilih tombol + (buat).
Untuk Jenis Pemicu, pilih Event.
Untuk sumber peristiwa, pilih integrasi yang event webhook-nya harus menjalankan agen. Hanya integrasi dengan webhook aktif yang terdaftar.
(Opsional) Untuk ekspresi Filter, masukkan ekspresi JMESPath untuk memfilter dan secara opsional mengubah payload peristiwa.
Pilih Buat.
Jika tidak ada sumber peristiwa yang terdaftar, tidak ada integrasi yang diaktifkan webhook di ruang agen, atau peran Anda kehilangan izin dan. ListAssociations ListWebhooks
Ekspresi filter:
Anda dapat secara opsional menentukan ekspresi filter JMESPath untuk mengontrol peristiwa mana yang memulai agen dan konteks apa yang diterima agen. Ekspresi filter dievaluasi terhadap root payload peristiwa mentah.
Sintaks — Spesifikasi JMESpath
Panjang maksimum - 4.096 karakter
Validasi — Ekspresi tidak valid ditolak saat Anda membuat pemicu
Ekspresi filter bertindak sebagai kondisi dan, secara opsional, proyeksi:
Ketika hasilnya bukan
null,false, string kosong, array kosong, atau objek kosong, pemicu berjalan.Ketika hasilnya adalah boolean
true(misalnya, predikat sepertiseverity == 'critical'), agen menerima payload peristiwa mentah sebagai konteks.Ketika hasilnya adalah nilai kebenaran lainnya (misalnya, seperti proyeksi
{sev: severity}), agen menerima hasil yang diproyeksikan sebagai konteks.
AWS DevOps Agen memotong konteks ini menjadi 10.000 karakter.
Jika Anda membiarkan ekspresi filter kosong, agen berjalan pada setiap peristiwa dari sumber tersebut dan menerima payload peristiwa mentah sebagai konteks.
catatan
Proyeksi yang mengevaluasi ke objek kosong atau array kosong dihitung sebagai tidak cocok, dan agen tidak berjalan. Untuk meneruskan nilai yang mungkin kosong, bungkus dalam objek literal. Misalnya, {payload: details}.
Contoh ekspresi filter:
severity == 'critical'— Predikat: menjalankan agen hanya ketika tingkat keparahan sama dengan kritis, meneruskan payload peristiwa mentah sebagai konteks.{sev: severity}— Proyeksi: menjalankan agen pada setiap peristiwa, meneruskan objek yang hanya berisi bidang keparahan sebagai konteks. Karena hash multiselect selalu menyertakan kuncinya, hasilnya tidak pernah kosong dan tidak memfilter.
Karena bentuk payload berbeda untuk setiap sumber, bidang yang tersedia bergantung pada integrasi. Ketika suatu peristiwa tiba tetapi pemicu tidak berjalan, AWS DevOps Agen mengeluarkan pemberitahuan yang menjelaskan alasannya. Misalnya, pemberitahuan mungkin menyatakan bahwa ekspresi filter tidak cocok. Pemberitahuan juga mencantumkan bidang tingkat atas yang ada di muatan itu. Untuk informasi selengkapnya, lihat Log dan Metrik Terjual.
Membuat pemicu secara terprogram
Anda juga dapat membuat pemicu secara terprogram menggunakan SDK. AWS Panggil CreateTrigger operasi devops-agent klien, yang membutuhkan aidevops:CreateTrigger izin. Atur jenis pemicu ke TIME_BASED dan berikan kondisi jadwal yang berisi ekspresi jadwal dan prompt pengguna opsional.
Atau, Anda dapat memodelkan pemicu berbasis jadwal sebagai AWS::DevOpsAgent::Trigger sumber daya di AWS CloudFormation. Pemicu mereferensikan agen kustom yang dijalankannya, jadi buat agen terlebih dahulu. Untuk informasi selengkapnya tentang jenis AWS::DevOpsAgent::Trigger sumber daya, lihatMengelola aset.
Mengelola pemicu
Tab Pem icu menampilkan semua pemicu yang dikonfigurasi untuk agen kustom. Pemicu jadwal menunjukkan ekspresi jadwalnya. Pemicu peristiwa menunjukkan sumber peristiwa dan, jika disetel, ekspresi filternya. Kedua jenis menunjukkan tanggal pembuatan.
Jika integrasi sumber atau webhook-nya dihapus, pemicu peristiwa tetap terdaftar tetapi menunjukkan bahwa sumber tidak lagi tersedia, dan tidak berjalan.
Menjeda pemicu:
Untuk menghentikan sementara pemicu memanggil agen tanpa menghapusnya, matikan sakelar sakelar di sebelah pemicu. Status pemicu berubah menjadi Dijeda dan tidak lagi berjalan sampai diaktifkan kembali. Nyalakan kembali sakelar untuk melanjutkan.
Menghapus pemicu:
Untuk menghapus pemicu secara permanen, pilih ikon hapus (tempat sampah) di sebelah pemicu yang ingin Anda hapus. Konfirmasikan penghapusan dalam dialog yang muncul. Pemicu yang dihapus tidak dapat dipulihkan.
Membatalkan pemanggilan
Anda dapat membatalkan pemanggilan yang sedang berjalan dari tampilan lintasan pemanggilan atau melalui Obrolan.
Untuk membatalkan pemanggilan yang sedang berjalan dari tampilan lintasan:
Dari tab Ri wayat, pilih pemanggilan yang sedang berjalan.
Pilih Bat al di bagian atas tampilan lintasan.
Untuk membatalkan pemanggilan yang sedang berjalan menggunakan Obrolan:
Cancel the running invocation of weekly-health-report.
Status pemanggilan berubah menjadi “Dibatalkan”. Setiap pekerjaan yang diselesaikan sebelum pembatalan dipertahankan dalam lintasan. Panggilan alat yang sedang berlangsung saat pembatalan terjadi mungkin masih selesai.
Hasil panggilan alat
Selama pemanggilan, agen khusus memanggil alat MCP untuk mengumpulkan data, melakukan tindakan, dan menghasilkan output. Setiap panggilan alat dan hasilnya direkam dalam lintasan pemanggilan.
Hasil panggilan alat memberikan transparansi tentang apa yang dilakukan agen selama pemanggilan:
Panggilan alat yang berhasil — Alat mengembalikan data yang digunakan agen untuk melanjutkan pekerjaannya. Misalnya,
query_cloudwatch_logsmengembalikan entri log, atauuse_awsmengembalikan respons API.Panggilan alat gagal — Alat mengembalikan kesalahan. Agen dapat mencoba lagi, mencoba pendekatan alternatif, atau melaporkan kegagalan dalam outputnya.
Anda dapat memeriksa panggilan alat individual dan hasilnya dalam lintasan pemanggilan untuk memahami perilaku agen, memverifikasi bahwa agen mengakses sumber daya yang benar, dan memecahkan masalah hasil yang tidak terduga. Untuk informasi selengkapnya tentang melihat lintasan, lihat Melihat lintasan pemanggilan.
