Sumber data yang dapat digunakan
Anda melihat pengajuan masuk ke alur keputusan, lalu menemukan masalah yang sama lagi. Nasabah lama diperlakukan seperti nasabah baru karena aturan tidak dapat membaca catatan yang tersimpan di core banking. Tim terkait mengatakan catatan itu sudah tersedia melalui API di gateway. Penyedia data juga menawarkan informasi berguna, seperti intelijen perangkat, tetapi kuncinya masih tersimpan di pengelola kata sandi tim Anda. Tiket integrasi menunggu di backlog tim platform, dengan pertanyaan tentang data apa yang akan dibaca aturan. Informasinya sudah tersedia, tetapi hanya sedikit yang dapat digunakan untuk mengambil keputusan.
Apa yang dimaksud dengan sumber data
Sumber data adalah pemanggilan REST API atau layanan web SOAP di internet publik. Anda mengatur pemanggilan tersebut sebagai sumber data. Seluruh alur keputusan dapat menggunakan responsnya, baik endpoint itu milik penyedia maupun layanan yang dijalankan perusahaan Anda.
| Metode | Kapan digunakan |
|---|---|
| GET | Pencarian sederhana dengan parameter di URL |
| POST | Permintaan yang lebih besar, berupa kolom formulir, JSON, atau templat isi mentah |
| PUT | Mengirim hasil keputusan ke sistem lain |
| SOAP | Layanan web lama yang menggunakan WSDL dan nama metode |
Anda dapat mengisi parameter dengan nilai tetap atau memetakannya dari objek data. Pilih “Flow” agar parameter muncul pada langkah alur keputusan dan dapat dipetakan. Placeholder di URL akan mengambil nilai dari parameter dengan nama yang sama. Anda juga dapat mengirim header bersama permintaan, termasuk kunci autentikasi.
Permintaan POST dapat mengirim kolom formulir, JSON, atau templat isi mentah. Dalam templat isi mentah, tulis format yang diharapkan API dan gunakan placeholder untuk nilai dari parameter. API dapat mengembalikan JSON atau XML. Engine mengubah respons XML menjadi struktur JSON, lalu menambahkannya ke objek data.
Anda dapat mengatur batas waktu untuk setiap sumber data, maksimal 15 detik. Jika API tidak merespons dalam batas waktu tersebut, alur tetap berjalan dan aturan Anda membaca kegagalan pemanggilan itu seperti nilai lainnya.
Ke mana respons dikirim
Decision engine menulis seluruh respons ke objek data, dengan $.output sebagai jalur awal, diikuti nama tahap dan nama sumber data. Aturan, tabel keputusan, scorecard, atau fungsi dapat membaca field apa pun yang dikembalikan menggunakan jalurnya.
Dalam contoh kasus, sumber bernama ip_check berada pada langkah bernama checks dan memberikan respons AbuseIPDB, sehingga sebuah aturan membaca $.output.checks.ip_check.abuseConfidenceScore.
Sistem juga mencatat detail panggilan bersama responsnya. Detail ini mencakup __http_code, __attempts, dan __cached. Jika panggilan gagal, output mencakup __error dan __error_details.
Autentikasi untuk pemanggilan API
Pilih metode autentikasi yang diminta endpoint. Pada layar sumber data, pilih “HTTP Authentication” untuk nama pengguna dan kata sandi, atau “OAuth2 Authentication” untuk endpoint token, client ID, dan secret. OAuth2 mendukung client credentials grant atau password grant, dengan scope, audience, atau realm jika diperlukan.
Engine menyimpan token OAuth2 di cache dan meminta token baru saat diperlukan. Jika API menolak token dengan respons 401, engine membuang token tersebut dan meminta penggantinya satu kali dalam pemanggilan itu. API key dapat dikirim melalui header atau parameter.
Kolom untuk key, token, atau kata sandi menggunakan kredensial dari vault. Konfigurasi hanya menyimpan referensi ke kredensial, bukan nilainya. Nilai tersebut tidak disertakan dalam ekspor maupun rilis.
Menghubungkan layanan milik perusahaan Anda
Alur keputusan dapat memanggil layanan perusahaan dengan cara yang sama seperti memanggil layanan penyedia. Berikut beberapa contoh pemanggilan yang dapat dilakukan pemberi pinjaman atau perusahaan asuransi dari keputusan:
- Catatan nasabah di sistem inti: produk yang digunakan, tunggakan, dan lama menjadi nasabah, sehingga nasabah yang sudah sepuluh tahun tidak lagi terlihat seperti orang asing.
- Layanan saldo atau eksposur untuk mengetahui saldo terkini di berbagai produk yang membatasi limit baru.
- Layanan harga atau produk yang menyimpan tabel suku bunga atau katalog produk, sehingga tabel tersebut tersimpan di satu tempat.
- Sistem CRM atau manajemen kasus untuk memeriksa apakah pengajuan, keluhan, atau kasus fraud untuk orang tersebut sudah terbuka.
- Layanan dokumen atau KYC Anda untuk mengetahui apakah dokumen identitas sudah diverifikasi dan kapan verifikasi dilakukan.
- Permintaan PUT ke sistem lain untuk mengirimkan hasil keputusan.
Decisimo memanggil alamat di internet publik. Berikan alamat layanan melalui API gateway Anda, lalu amankan dengan key atau OAuth2. Alamat loopback, rentang privat 10/8, 172.16/12, dan 192.168/16, serta alamat link-local akan ditolak sebelum pemanggilan dilakukan. Untuk alamat yang ditolak, field __error_details.type bernilai ssrf_blocked. Pengalihan tidak diikuti, jadi konfigurasi URL tujuan akhirnya secara langsung.
Sistem inti yang lebih lama sering menggunakan SOAP. Atur URL WSDL dan nama metodenya, lalu petakan parameter bertingkat berdasarkan lokasinya. Versi SOAP mengikuti binding di WSDL, sedangkan responsnya diubah menjadi JSON seperti respons REST.
Beberapa pemanggilan, kegagalan, dan percobaan ulang
Dalam satu langkah, Anda dapat menggabungkan beberapa sumber data. Engine memanggil semuanya secara bersamaan, dan langkah tersebut menunggu respons yang paling lambat. Jadi, gabungkan pemeriksaan berbiaya rendah dalam satu langkah. Pemohon hanya perlu menunggu respons yang paling lambat di antara semuanya.
Batas waktu terlampaui, koneksi gagal, endpoint diblokir, atau terjadi kesalahan HTTP tidak akan menghentikan seluruh alur keputusan. Output mencatat kesalahan beserta penyebabnya, lalu alur tetap berjalan. Aturan dapat mengarahkan pengajuan ke jalur cadangan atau antrean pemeriksaan manual. Baca strategi keputusan yang tetap berjalan saat penyedia gagal untuk mengetahui cara mengatur jalur cadangan.
Gunakan “Retry this call if it fails” hanya jika panggilan kedua aman untuk ditagihkan dan dicatat. Untuk sumber yang diatur agar dicoba ulang, engine melakukan upaya kedua setelah koneksi gagal atau menerima respons HTTP 408, 425, 429, 502, 503, atau 504. Jeda sebelum percobaan ulang berkisar antara 200 milidetik hingga 2 detik. Percobaan ulang hanya dilakukan selama waktu yang tersedia untuk langkah tersebut, dan __attempts mencatat jumlah percobaan.
Anda juga dapat menyimpan respons sumber data dalam cache untuk setiap langkah keputusan, di tujuan Data cache pada database PostgreSQL milik Anda. Durasi cache default adalah 30 hari. Kecocokan dapat ditentukan berdasarkan permintaan atau kumpulan parameter pilihan Anda. Kredensial tidak menjadi bagian dari pencocokan, dan error tidak disimpan. Field __cached menunjukkan apakah jawaban yang tersimpan digunakan untuk langkah tersebut.
Minta assistant menyusun konfigurasi sumber data
Tombol “AI Assistant” di layar sumber data membuka chat. Jelaskan API yang ingin Anda hubungkan, lalu assistant akan mengusulkan konfigurasinya. Tinjau usulan di samping pengaturan yang sedang digunakan. “Apply Configuration” mengisi formulir, lalu Save menyimpan sumber data.
Jika API memerlukan kunci, kotak “Credential needed” memungkinkan Anda memilih kredensial yang sudah ada atau menambahkan kredensial ke vault. Percakapan menyertakan nama kredensial tersebut. Asisten alur juga dapat menambahkan tugas sumber data saat Anda menyusun alur keputusan.
Pilih “Run test” untuk memanggil sumber data dan melihat responsnya.
Penyedia yang digunakan
Respons Fingerprint memuat ID pengunjung dan informasi apakah perangkat terindikasi sebagai bot. MaxMind minFraud mengembalikan skor risiko dan informasi apakah alamat email bersifat sementara. Trestle menunjukkan apakah alamat email valid dan jenis nomor telepon yang digunakan.
Untuk pemeriksaan email, Have I Been Pwned menunjukkan kebocoran data yang memuat suatu alamat, termasuk tanggal dan jenis datanya. Email Hippo memeriksa alamat email itu sendiri. Untuk pemeriksaan IP dan perangkat, AbuseIPDB memberikan skor keyakinan penyalahgunaan dari 0 hingga 100. Panduan macaddress.io dan WhatIsMyBrowser menjelaskan cara menghubungkan dua pemeriksaan perangkat lainnya.
Panduan lain membahas BINLIST untuk kartu, Companies House untuk informasi perusahaan, dan Google Places untuk data geografis dan alamat. Semuanya tersedia di halaman integrasi, yang mengelompokkan penyedia berdasarkan jenis pemeriksaan.
Selain sumber data, alur dapat memanggil model LLM dengan templat prompt yang diisi dari data keputusan dan format output opsional. Alur juga dapat memanggil model terlatih milik Anda sebagai langkah alur. Daftar blokir, daftar izin, dan daftar pantauan milik Anda tetap berada di database, lalu diperiksa oleh alur saat berjalan.
Pertanyaan yang sering diajukan
Bisakah Decisimo memanggil layanan di jaringan privat kami?
Sediakan alamat layanan melalui API gateway agar dapat diakses dari internet publik. Alamat jaringan privat akan ditolak sebelum pemanggilan dilakukan.
Apa yang terjadi jika penyedia lambat merespons?
Anda dapat mengatur batas waktu hingga 15 detik. Jika penyedia tidak merespons tepat waktu, alur tetap berjalan dengan mencatat kesalahan dan penyebabnya. Aturan Anda menentukan tindakan berikutnya.
Siapa yang memegang kontrak dengan penyedia?
Kontrak dan key dengan penyedia tetap menjadi tanggung jawab Anda. Decisimo tidak menyediakan data dari penyedia tersebut.
Bisakah satu langkah memanggil dua penyedia?
Kedua sumber data dipanggil secara bersamaan, dan langkah tersebut menunggu respons yang paling lama.