Aksita.ai Tutorial
Actions

HTTP Actions

Panggil REST API eksternal untuk melakukan tindakan dari agent Anda

Apa itu HTTP Action?

HTTP Action memungkinkan agent Anda memanggil REST API eksternal untuk melakukan tindakan seperti mengirim email, membuat order, update database, dll. Agent akan otomatis mengekstrak informasi dari percakapan user dan mengirimkannya ke API.

Contoh Penggunaan:
  • • Kirim email ke tim support
  • • Buat order produk
  • • Update status pengiriman
  • • Kirim notifikasi WhatsApp

Cara Membuat HTTP Action

  1. 1
    Buka Resources → Actions
    Resources Page

    Halaman Resources Agent

    Dari halaman agent, klik tab "Resources" kemudian pilih "Actions" → "HTTP"

  2. 2
    Isi Name dan Description
    HTTP Action Form

    Form HTTP Action

    Berikan nama dan deskripsi yang jelas agar agent tahu kapan harus menggunakan action ini.

    Name *

    Nama singkat dan deskriptif untuk action ini

    Contoh: "Send Email to Support"
    Description *

    Jelaskan apa yang dilakukan action ini dan kapan agent harus menggunakannya

    Contoh: "Mengirim email ke tim support ketika user memiliki masalah yang perlu ditangani support"
  3. 3
    Masukkan URL API
    HTTP Action Form

    Form HTTP Action dengan URL dan Method

    Masukkan URL lengkap dari API dan pilih HTTP method

    Pilih HTTP Method:

    GET
    POST
    PUT
    PATCH
    DELETE

    Masukkan URL:

    https://api.example.com/support/email
    Dynamic Parameters

    Gunakan <param> untuk parameter dinamis:

    https://api.example.com/users/<userId>/orders
  4. 4
    Tambahkan Headers (Opsional)
    HTTP Action Headers

    Tambahkan Headers untuk Authentication

    Headers untuk authentication (API key, token) dan konfigurasi lainnya

    Authorization:

    Key: Authorization
    Value: Bearer sk-abc123...

    Content-Type:

    Key: Content-Type
    Value: application/json
  5. 5
    Definisikan Body Parameters
    HTTP Action Body Parameters

    Definisikan Body Parameters

    Data yang akan dikirim ke API. Agent akan ekstrak dari percakapan user.

    subject required

    Judul email

    message required

    Isi pesan dari user

    priority optional

    Prioritas: high, normal, low

    Agent akan mengirim JSON:

    { "subject": "...", "message": "...", "priority": "high" }
  6. 6
    Set Success Condition
    HTTP Action Success Condition

    Set Success Condition

    Tentukan kapan API call dianggap berhasil atau gagal

    STATUS CODE

    Cek HTTP status code

    Status Code = 200
    RESPONSE VALUE

    Cek nilai di response JSON

    response.status = "success"
  7. 7
    Test Konfigurasi
    Test HTTP Action

    Test HTTP Action

    Test sebelum menyimpan untuk memastikan API berfungsi

    Success

    ✅ Hijau = berhasil, ❌ Merah = gagal

    Status Code

    200 = OK, 404 = Not Found, 500 = Error

    Response

    Data dari API

    Execution Time

    Waktu respon (ms)

  8. 8
    Klik "Create"
    Action Created

    Action berhasil dibuat

    Jika test berhasil, klik "Create" untuk menyimpan. Action langsung siap digunakan!

    Siap Digunakan!

    Agent Anda sekarang bisa menggunakan action ini. Coba chat dan minta agent melakukan action!

Tips & Best Practices

Deskripsi Jelas

Tulis deskripsi detail agar agent tahu kapan menggunakan action

Test Dulu

Selalu test sebelum menyimpan

Parameter Jelas

Beri deskripsi jelas di setiap parameter

Gunakan Success Condition

Set condition agar agent beri feedback tepat