Aksi Agen AI: Make HTTP requests

Kelayakan paket: Tersedia pada paket Advanced, Enterprise, dan paket Legacy terpilih. Pengujian tersedia untuk semua pengguna, tetapi penerbitan memerlukan paket yang memenuhi syarat.

Aksi Make HTTP requests memungkinkan Agen AI Anda memanggil API eksternal selama percakapan. Ini memungkinkan Agen AI mengambil data real-time atau memicu tindakan di sistem eksternal berdasarkan permintaan Kontak. Misalnya, ia dapat memeriksa status pesanan, mengambil informasi akun, atau membuat catatan di sistem lain. Dalam artikel ini, Anda akan mempelajari cara mengonfigurasi aksi permintaan HTTP dan mengujinya dengan Agen AI Anda.

Agen AI:

1. Menganalisis pesan Kontak untuk menentukan apakah sesuai dengan niat yang didefinisikan dalam instruksi aksi Anda.

2. Mengumpulkan informasi yang diperlukan.

3. Mengirim permintaan HTTP.

4. Menafsirkan respons API.

5. Membalas Kontak secara alami.

Tambahkan aksi Make HTTP requests

Aktifkan aksi dan klik tombol “Add action” untuk mulai mengonfigurasi permintaan HTTP Anda.

Tentukan kapan aksi harus dijalankan

Berikan nama deskriptif untuk aksi di kolom Action name.

Di bagian When and how should this action be performed? kolom, jelaskan:

• Kapan Agen AI harus menggunakan aksi ini

• Apa yang diambil atau dikirim

• Kondisi atau hasil apa pun yang harus ditangani

Contoh:

Gunakan aksi ini untuk mengambil status pesanan Kontak ketika mereka menanyakan tentang pesanan mereka. Jika API mengembalikan kode 404, beri tahu Kontak bahwa pesanan tidak dapat ditemukan.

Agen AI menggunakan deskripsi ini untuk memutuskan kapan memicu permintaan.

Informasi yang mungkin dibutuhkan Agen AI (opsional)

Tentukan input yang dibutuhkan di bagian ini sebelum memanggil API Anda.

Ini adalah variabel terstruktur yang harus dikumpulkan oleh Agen AI. Permintaan dipicu hanya setelah semua input yang diperlukan tersedia.

Jika sebuah nilai:

• Sudah disebutkan dalam percakapan → Agen AI menggunakannya.

• Belum ada → Agen AI akan meminta nilai tersebut dari Kontak.

Variabel yang dibuat di sini dapat digunakan dalam konfigurasi API. Variabel Kontak (seperti $contact.email) tersedia secara otomatis dan tidak perlu ditambahkan.

Pengaturan Bidang

Konfigurasi API

Tentukan bagaimana Agen AI harus memanggil API Anda.

Anda dapat mengonfigurasi:

• Metode

• URL

• Parameter kueri

• Header

• Body JSON (untuk POST, PUT, PATCH)

Referensi variabel

Anda dapat memasukkan variabel di URL, parameter, header, atau body dengan menggunakan $.

Ada dua jenis:

• Variabel Kontak — bidang Kontak yang ada

  • $contact.email

• Variabel Agen AI — bidang yang didefinisikan di bawah Informasi yang mungkin dibutuhkan Agen AI

  • $agent.order_id

Variabel digantikan dengan nilai nyata saat permintaan dijalankan. Jika variabel Agen AI yang diperlukan hilang, Agen AI akan memintanya sebelum memicu panggilan API.

Cara Agen AI menangani respons API

Contoh body:

{
  "order_id": "$agent.order_id",
  "email": "$contact.email"
}

Agen AI secara otomatis menafsirkan respons JSON dari API dan menghasilkan balasan alami.

Contoh respons API:

{
  "status": "shipped",
  "eta": "2025-12-12"
}

Balasan AI: “Kabar baik! Pesanan Anda telah dikirim dan diperkirakan tiba pada 12 Desember 2025.”

Pengujian

Anda dapat menguji aksi permintaan HTTP Anda di panel Test AI Agent sebelum dipublikasikan.

Cara menguji

1. Mulai percakapan uji yang sesuai dengan kondisi aksi Anda.

   

2. Ketika niat terdeteksi dan input yang diperlukan tersedia, Agen AI mengeksekusi permintaan HTTP.

3. Peristiwa eksekusi muncul di panel pengujian:

   

   1. {AI Agent name} mengeksekusi {Action name}

   2. Respons 2xx ditampilkan sebagai sukses

   3. Semua kode status lainnya ditampilkan sebagai kegagalan

4. Klik peristiwa untuk melihat:

   1. Response tab (default) — seluruh body respons API

   2. Request tab — payload permintaan cURL lengkap

   3. Opsi salin untuk debugging

5. Setelah menerima respons API, Agen AI menghasilkan balasan berdasarkan data yang dikembalikan.

Catatan penting

• Peristiwa eksekusi muncul hanya di panel Test AI Agent. Mereka tidak muncul di Inbox atau Aktivitas Kontak.

• Jika input yang diperlukan hilang, Agen AI akan memintanya sebelum memicu permintaan.

Praktik terbaik

• Jelaskan aksi Anda secara tepat. Instruksi yang tidak jelas menyebabkan pemicu yang tidak jelas.

• Tentukan input yang diperlukan dengan jelas. Jika AI harus meminta sesuatu, buat agar jelas.

• Tangani kasus kesalahan dalam instruksi Anda.

• Selalu uji sebelum dipublikasikan.

• Hindari menduplikasi logika yang sudah ditangani oleh Workflows, kecuali jika memang dirancang demikian.

Keterbatasan

• Maksimum 10 aksi permintaan HTTP per Agen AI.

• Maksimum per aksi:

  • 20 bidang input data

  • 50 parameter

  • 50 header

• Agen AI menentukan kapan memanggil API berdasarkan deskripsi tertulis Anda. Instruksi yang ditulis dengan buruk dapat menyebabkan pemicu yang tidak terduga.

• Penanganan respons API bersifat otomatis. Anda tidak dapat memetakan bidang respons secara manual — Agen AI menafsirkan JSON secara kontekstual.

• Peristiwa eksekusi permintaan HTTP muncul hanya di panel Test AI Agent dan tidak di Aktivitas Kontak.

• Agen AI suara dapat memicu aksi Make HTTP requests. Namun, respons API yang dikembalikan tidak dikirim kembali ke Agen AI suara untuk pembuatan balasan, sehingga percakapan suara tidak dapat merespons secara dinamis berdasarkan hasil API.