Aksita.ai Tutorial
Knowledge Base

HTTP Knowledge Base

Ambil data dari API endpoint dengan dukungan headers dan authentication

Apa itu HTTP KB?

HTTP Knowledge Base memungkinkan Anda mengambil data dari API endpoint dengan dukungan custom headers dan authentication. Cocok untuk data yang memerlukan API key atau token, atau data yang sering berubah dan perlu di-refresh secara berkala.

Dengan Auth

Support custom headers & API keys

Data Dinamis

Cocok untuk data yang sering berubah

API Response

Ekstrak data dari JSON/XML

Kapan Menggunakan HTTP KB?

Data Produk dari API

Ambil data produk, harga, stok dari e-commerce API

Konten dari CMS API

Artikel, blog posts, atau konten dari headless CMS

Data Real-time

Data yang sering berubah seperti harga, status, availability

Data yang Butuh Auth

Resource yang memerlukan API key atau Bearer token

Cara Membuat HTTP KB

  1. 1
    Buka Resources → Create Resource
    Resources Page

    Halaman Resources Agent

    Pilih Knowledge → HTTP

  2. 2
    Isi Nama & Deskripsi
    HTTP KB Form

    Form HTTP URL

    Berikan nama dan deskripsi yang jelas untuk knowledge base ini

    Name

    Product Catalog API

    Description

    Mengambil data produk dari API
  3. 3
    Masukkan API URL
    HTTP KB Form

    Form HTTP Knowledge Base

    Masukkan URL lengkap dari API dan pilih HTTP method

    Pilih HTTP Method:

    GET
    POST
    PUT
    PATCH
    DELETE

    Masukkan URL:

    https://api.example.com/v1/products
    https://api.example.com/articles?limit=100
    Dynamic Parameters

    Gunakan <param> untuk parameter dinamis yang akan diekstrak dari percakapan:

    https://api.example.com/users/<userId>/orders
    https://api.example.com/products?category=<category>&limit=<limit>

    Agent akan otomatis ekstrak parameter dari percakapan user

  4. 4
    Tambahkan Headers (Opsional)
    HTTP KB Headers

    Tambahkan Headers untuk Authentication

    Custom headers untuk authentication atau konfigurasi:

    Authorization: Bearer YOUR_API_KEY
    Content-Type: application/json
    API-Key: your-api-key-here
  5. 5
    Definisikan Body Parameters (Opsional)
    HTTP KB Body Parameters

    Definisikan Body Parameters

    Untuk POST/PUT/PATCH: Data yang akan dikirim ke API. Agent akan ekstrak dari percakapan user.

    query required

    Kata kunci pencarian

    limit optional

    Jumlah hasil (default: 10)

    Agent akan mengirim JSON:

    { "query": "...", "limit": 10 }
  6. 6
    Set Success Condition (Opsional)
    HTTP KB 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 KB

    Test HTTP KB

    Test sebelum menyimpan untuk memastikan API mengembalikan data yang valid

    Success/Failed

    ✅ 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"
    HTTP KB Created

    HTTP KB Berhasil Dibuat

    Jika test berhasil, klik Create untuk menyimpan knowledge base

Tips & Best Practices

Gunakan API yang Stabil

Pastikan API reliable dan tidak sering down

Jaga Keamanan API Key

Gunakan API key khusus untuk read-only jika memungkinkan

Perhatikan Rate Limit

Pastikan tidak melebihi rate limit API

Test di Environment Aman

Test dengan staging/dev API dulu sebelum production

Test Konfigurasi

Sebelum menyimpan knowledge base, Anda dapat menguji konfigurasi HTTP untuk memastikan API mengembalikan data yang valid.

Cara Test

  1. 1. Isi semua field konfigurasi (URL, Method, Headers)
  2. 2. Klik tombol "Test" di bagian bawah form
  3. 3. Sistem akan mengirim request dan menampilkan preview data
  4. 4. Pastikan response berisi data yang relevan

Informasi Test Result

Success

Menunjukkan apakah request berhasil atau gagal

Status Code

HTTP status code (200, 404, 500, dll)

Response

Data response dari API (JSON atau text)

Execution Time

Waktu eksekusi request dalam milidetik

Validasi Data

Setelah test berhasil, sistem akan otomatis mengekstrak dan memproses data untuk dijadikan knowledge base. Pastikan response API berisi informasi yang relevan dan terstruktur dengan baik.