Knowledge Eksternal

Knowledge Eksternal memungkinkan agent mencari di knowledge base lain selama percakapan, selain dokumen, website, dan video miliknya sendiri. Setiap sumber yang Anda tambahkan disebut provider. Sebuah provider dapat berupa:

• Search API agent lain. Knowledge milik agent Qlar lain yang Anda kelola, melalui API Pencarian Knowledge agent tersebut. Qlar mengisi endpoint dan membuatkan key untuk Anda.
• REST API. Layanan pencarian milik Anda sendiri yang menerima request dan mengembalikan response yang sama dengan API Pencarian Knowledge. Anda memasukkan endpoint dan key-nya.
• Knowledge gateway (segera hadir). Program kecil di jaringan Anda sendiri yang menjawab pencarian dari knowledge yang tidak boleh keluar dari jaringan itu, seperti yang dilakukan On-premise Gateway untuk database.

Gunakan fitur ini jika knowledge yang dibutuhkan agent disimpan di tempat lain dan menyalinnya berarti harus menjaga dua salinan tetap sinkron, misalnya:

• Agent knowledge bersama. Tim HR mengelola satu agent berisi semua kebijakan. Agent front desk, agent onboarding, dan agent helpdesk IT mencari di sana, alih-alih masing-masing menyimpan salinan sendiri.
• Knowledge milik tim lain. Agent sales menjawab pertanyaan produk dari agent milik tim produk, yang selalu diperbarui oleh tim itu.
• Layanan pencarian yang sudah Anda jalankan. Pencarian intranet Anda sudah mengindeks ribuan dokumen. Agent bertanya ke sana, alih-alih Anda meng-upload ulang dokumennya.

Dalam contoh Mengajari Agent Anda, Atlas menyimpan SOP Kirana Group. Agent customer service Kirana, Brew, kadang mendapat pertanyaan tentang persetujuan pembelian. Alih-alih meng-upload SOP ke Brew juga, Brew mendapat Atlas sebagai provider dengan deskripsi "SOP internal tentang pembelian, persetujuan, dan capex", sehingga Brew hanya mencari di Atlas ketika pertanyaannya tentang hal-hal itu.

Cara agent memakai provider

Setiap provider yang aktif menjadi satu tool bagi agent, di samping knowledge base miliknya sendiri. Agent membaca "What information to look up here" milik provider dan memutuskan, pertanyaan demi pertanyaan, apakah perlu mencari di sana. Pertanyaan tentang hal yang tidak dicakup provider tidak sampai ke provider, jadi tidak menimbulkan biaya.

Ketika agent mencari di sebuah provider:

1. Qlar mengirim kata kunci pencarian, permission milik provider, dan jumlah hasil pencarian ke provider.
2. Provider menjawab dengan chunk yang cocok, dalam urutannya sendiri.
3. Jika reranker agent aktif (Knowledge → Retrieval), hasilnya di-rerank dengan model reranker agent dan dipotong sesuai jumlah hasil pencarian agent, persis seperti knowledge miliknya sendiri. Jika reranker mati, semua hasil dari provider dipakai apa adanya. Provider tidak punya pengaturan reranking sendiri.
4. Agent menjawab dari hasil tersebut. Saat sitasi aktif, sitasi menampilkan nama provider dan judul chunk, misalnya [Atlas SOPs · Project and Capex Approval Policy · 3. Approval limits]. Sitasi ini bukan link: chunk-nya berada di knowledge base lain, bukan milik agent ini.

Agent memperlakukan hasil provider sebagai data, tidak pernah sebagai instruksi. Jika provider tidak bisa dihubungi atau menolak pencarian, agent diberi tahu dan menjawab tanpanya; percakapan tidak gagal.

Sebelum memulai

• Siapa yang bisa menambah provider. Contributor agent serta Owner dan Admin organisasi, yaitu orang yang sama yang mengelola knowledge agent.
• Semua agent bisa memakai provider, baik personal maupun service.
• Paling banyak 5 provider per agent.
• Untuk provider agent, agent lain itu harus berupa service agent dengan Channels → Search API menyala, dan Anda juga harus bisa mengelola agent tersebut. Lihat API Pencarian Knowledge.

Menambah provider

Di CMS, buka Knowledge → External pada sidebar agent Anda dan pilih Add provider. Pilih jenis provider terlebih dahulu, lalu isi formulirnya.

Search API agent lain

1. Pilih Another agent's Search API lalu Continue.
2. Di Agent, pilih agent yang akan dicari. Daftarnya berisi agent yang Anda kelola dan Search API-nya menyala, beserta organisasinya.
3. Endpoint sudah terisi otomatis. API key dibuat otomatis saat Anda menambahkan provider (lihat Key yang dibuat untuk provider).
4. Isi kolom bersama lalu pilih Add provider.

Jika agent lain itu memberlakukan permission wajib pada Search API-nya, formulir memberi tahu Anda: kode tersebut tetap ditambahkan ke setiap pencarian.

REST API

1. Pilih REST API lalu Continue.

2. Isi:

   Kolom	Yang diisi
   Endpoint	URL pencarian. Harus diawali https:// dan dapat dijangkau dari internet: alamat di jaringan privat atau lokal ditolak.
   API key	Key yang diminta layanan tersebut. Disimpan terenkripsi dan tidak pernah ditampilkan lagi; saat mengedit provider nanti, biarkan kosong untuk mempertahankan key yang tersimpan.
   Send the key as	Header X-Api-Key (seperti API Pencarian Knowledge) atau Authorization: Bearer.

3. Isi kolom bersama. Anda bisa menguji sebelum menambahkannya.

4. Pilih Add provider.

Layanan tersebut harus mengikuti kontrak ini (sama dengan API Pencarian Knowledge):

POST {endpoint}
X-Api-Key: {key}            (atau Authorization: Bearer {key})
Content-Type: application/json

{ "query": "Siapa yang menyetujui capex di atas USD 50.000?", "permissions": ["FINANCE"], "limit": 5 }

{
  "results": [
    {
      "chunkCode": "SOP-FIN-007-0004",
      "title": "Project and Capex Approval Policy",
      "section": "3. Approval limits",
      "text": "Capital expenditure above USD 50,000 requires approval from the Finance Controller...",
      "distance": 0.18
    }
  ]
}

Hanya text yang wajib di setiap hasil; chunkCode, contentId, title, section, dan distance opsional. Field lain diabaikan. Paling banyak 20 hasil yang dibaca, jawabannya harus lebih kecil dari 1 MB, dan layanan harus menjawab dalam 15 detik. Redirect tidak diikuti.

Kolom bersama

Menguji provider

Setiap formulir provider punya bagian Test. Ketik pertanyaan lalu pilih Run test: Qlar menjalankan satu pencarian dengan nilai di formulir dan menampilkan hasilnya dalam urutan provider, lengkap dengan judul, section, dan distance. Reranking tidak diterapkan saat pengujian.

• Provider REST dapat diuji sebelum ditambahkan, dengan endpoint dan key yang Anda ketik.
• Provider agent dapat diuji setelah ditambahkan, karena key-nya dibuat saat ditambahkan. Setelah Anda menambahkannya, formulir tetap terbuka pada provider baru agar Anda bisa langsung mengujinya.
• Pengujian yang gagal menyebutkan sebabnya, misalnya key ditolak, waktu habis, atau jawaban yang formatnya tidak sesuai.

Menguji provider agent menjalankan pencarian sungguhan di agent lain, sehingga memakan 1 credit milik organisasi agent itu dan tercatat di log pencarian agent itu, sama seperti pencarian lainnya.

Key yang dibuat untuk provider

Saat Anda menambah provider agent, Qlar membuat key di agent lain itu khusus untuk provider ini. Anda tidak pernah melihat atau menyalinnya: key disimpan terenkripsi dan hanya dipakai oleh agent yang mencari.

Di agent lain, key ini muncul di Channels → Search API → Access → Used by other agents, beserta nama agent yang memakainya. Contributor agent lain itu dapat mencabut (revoke) key tersebut kapan saja. Key seperti ini tidak memakai salah satu dari dua slot key agent tersebut.

Permission

Kode permission bekerja seperti pada knowledge milik agent sendiri: chunk tanpa kode selalu bisa ditemukan, dan chunk dengan kode hanya ditemukan jika pencarian membawa salah satu kodenya. Lihat Permission Knowledge.

Sebuah provider mengirim kode yang sama di setiap pencarian: kode yang Anda atur pada provider. Kode ini tidak berubah mengikuti user yang sedang chat. Untuk provider agent, agent lain itu juga menambahkan permission wajib miliknya ke setiap pencarian. Berikan provider hanya kode yang boleh dilihat oleh semua user agent Anda.

Tagihan

Provider hanya dicari ketika agent menilai provider itu relevan, sehingga What information to look up here yang ditulis dengan baik juga menekan biaya.

Batasan

Pencarian ke agent lain juga dihitung dalam batas rate Search API agent tersebut.

Pemecahan masalah

Halaman terkait

• API Pencarian Knowledge: API yang dicari oleh provider agent, dan cara membuka knowledge agent Anda untuk sistem lain.
• Retrieval: reranker dan jumlah hasil pencarian yang juga berlaku untuk hasil provider.
• Permission Knowledge
• Sitasi
• Referensi layar Knowledge Eksternal