Bot & chat

Membuat bot

POST /bots
x-lex-client: aplikasi-saya
Content-Type: application/json

{
  "name": "Asisten Riset",
  "description": "Mencari dan merangkum sumber",
  "defaultMode": "cendikia",
  "instructions": "Jawab dalam Bahasa Indonesia. Sebutkan sumbernya.",
  "character": { "outfit": "pro", "hat": "#4A8FE0", "accessory": "glasses" }
}

Field	Catatan
name	1–80 karakter
defaultMode	nalar (cepat), patih (seimbang, bawaan), atau cendikia (mendalam)
instructions	Maksimal 8.000 karakter. Tidak bisa mengesampingkan kebijakan keamanan workspace.
character	Karakter Lex milik bot: outfit (default, casual, pro, cool, female), hat (warna hex untuk topi, sepatu, dan syal), accessory (none, glasses, sunglasses)

Endpoint bot lainnya: GET /bots, GET /bots/{botId}, PATCH /bots/{botId}, DELETE /bots/{botId} (arsipkan), POST /bots/{botId}/restore, GET /bots/archived, dan DELETE /bots/{botId}/permanent. Menghapus bot secara permanen menghentikan semua run yang masih berjalan.

Satu chat per bot

Setiap bot punya satu thread chat yang berkelanjutan per pengguna.

• GET /chats menampilkan chat setiap bot beserta pesan terakhirnya (untuk sidebar).
• GET /chats/thread?botId=… mengembalikan thread bot tersebut, dan membuatnya saat pertama dipakai.
• GET /conversations/{conversationId}/messages mengembalikan pesan-pesannya, dari yang terlama.
• DELETE /chats/thread/messages?botId=… membersihkan chat (dan menghentikan balasan yang sedang berjalan).

Mengirim pesan

POST /agent-runs
x-lex-client: aplikasi-saya
Content-Type: application/json

{ "botId": "bot_123", "message": "Rangkum email penjualan minggu ini", "mode": "patih" }

{ "runId": "run_456", "conversationId": "conv_789", "status": "queued", "eventsUrl": "/api/v1/agent-runs/run_456/events" }

Field	Catatan
message	1–20.000 karakter
botId	Bot yang diajak bicara. Pesan masuk ke thread bot itu.
mode	Menggantikan mode bawaan bot untuk pesan ini
attachmentIds	File yang sudah diunggah sebelumnya, lihat Lampiran & tag
mentions	Connector, plugin, atau Mini Program yang dipakai, lihat Lampiran & tag

Lalu ikuti run-nya untuk mendapatkan balasan. Setelah selesai, balasan juga tersimpan sebagai pesan assistant di thread.

Siklus hidup run

queued → running ⇄ waiting_for_approval → completed
                                         ↘ failed | cancelled | timed_out

• GET /agent-runs/{runId} mengembalikan run beserta status, output, dan lastEventSeq.
• POST /agent-runs/{runId}/cancel menghentikannya.
• GET /agent-runs/{runId}/tool-executions menampilkan tool yang dipakai.
• GET /agent-runs?botId=… menampilkan run terbaru.