:Integrasikan asisten AI dengan Lark

Create a Lark app

1. Buka Lark Open Platform atau Lark Open Platform, klik Create Custom Enterprise App, masukkan nama dan deskripsi aplikasi, pilih ikon aplikasi, lalu klik Create.

2. Di panel navigasi sebelah kiri, buka halaman Credentials & Basic Information. Salin App ID (misalnya, cli_xxx) dan App Secret.

3. Di panel navigasi sebelah kiri, klik Permissions & Scopes. Klik Bulk Import/Export Permissions, tempel konfigurasi JSON berikut, klik Next, konfirmasi izin baru, lalu klik Request to Activate.

   JSON configuration

   {
     "scopes": {
       "tenant": [
         "contact:contact.base:readonly",
         "docx:document:readonly",
         "im:chat:read",
         "im:chat:update",
         "im:message.group_at_msg:readonly",
         "im:message.p2p_msg:readonly",
         "im:message.pins:read",
         "im:message.pins:write_only",
         "im:message.reactions:read",
         "im:message.reactions:write_only",
         "im:message:readonly",
         "im:message:recall",
         "im:message:send_as_bot",
         "im:message:send_multi_users",
         "im:message:send_sys_msg",
         "im:message:update",
         "im:resource",
         "application:application:self_manage",
         "cardkit:card:write",
         "cardkit:card:read"
       ],
       "user": [
         "contact:user.employee_id:readonly",
         "offline_access",
         "base:app:copy",
         "base:field:create",
         "base:field:delete",
         "base:field:read",
         "base:field:update",
         "base:record:create",
         "base:record:delete",
         "base:record:retrieve",
         "base:record:update",
         "base:table:create",
         "base:table:delete",
         "base:table:read",
         "base:table:update",
         "base:view:read",
         "base:view:write_only",
         "base:app:create",
         "base:app:update",
         "base:app:read",
         "board:whiteboard:node:create",
         "board:whiteboard:node:read",
         "calendar:calendar:read",
         "calendar:calendar.event:create",
         "calendar:calendar.event:delete",
         "calendar:calendar.event:read",
         "calendar:calendar.event:reply",
         "calendar:calendar.event:update",
         "calendar:calendar.free_busy:read",
         "contact:contact.base:readonly",
         "contact:user.base:readonly",
         "contact:user:search",
         "docs:document.comment:create",
         "docs:document.comment:read",
         "docs:document.comment:update",
         "docs:document.media:download",
         "docs:document:copy",
         "docx:document:create",
         "docx:document:readonly",
         "docx:document:write_only",
         "drive:drive.metadata:readonly",
         "drive:file:download",
         "drive:file:upload",
         "im:chat.members:read",
         "im:chat:read",
         "im:message",
         "im:message.group_msg:get_as_user",
         "im:message.p2p_msg:get_as_user",
         "im:message:readonly",
         "search:docs:read",
         "search:message",
         "space:document:delete",
         "space:document:move",
         "space:document:retrieve",
         "task:comment:read",
         "task:comment:write",
         "task:task:read",
         "task:task:write",
         "task:task:writeonly",
         "task:tasklist:read",
         "task:tasklist:write",
         "wiki:node:copy",
         "wiki:node:create",
         "wiki:node:move",
         "wiki:node:read",
         "wiki:node:retrieve",
         "wiki:space:read",
         "wiki:space:retrieve",
         "wiki:space:write_only"
       ]
     }
   }

4. Di bilah navigasi kiri, klik Add Application Capability, pilih tab Add by Capability, temukan kartu bot, lalu klik Configuration.

   

5. Konfigurasikan langganan event.

   1. Kembali ke DataWorks console dan buat instans DataClaw. Untuk informasi selengkapnya, lihat AI assistant configuration.

   2. Di panel navigasi sebelah kiri Lark Open Platform, klik Event Subscriptions. Di tab Event Subscription, di bawah Subscription Method, pilih Use long-lived connection to receive events, lalu klik Save.

   3. Di halaman Event Subscription, klik Add Event. Di tab Subscribe as App, cari "message", lalu pilih event Receive messages, Message reaction created, dan Message reaction canceled. Kemudian klik Confirm.

6. Di halaman Version Management and Publishing, buat versi, masukkan app version dan update notes, klik Save, kirim untuk ditinjau, lalu publikasikan.

Configure the bot

Anda dapat membuat grup chat baru atau menambahkan bot ke grup yang sudah ada. Untuk menguji bot, sebutkan bot tersebut dengan mengetik @<bot_name> di grup chat atau cari bot tersebut untuk memulai chat pribadi.

Untuk menggunakan bot di grup chat eksternal, lihat dokumen Bots can be used in external chats and DMs with external users.

1. Tambahkan bot melalui jalur berikut: ... > Configure > Group bot > Add bot.

2. Klik avatar bot, lalu klik Send Message untuk memulai chat pribadi. Untuk mengirim pesan ke bot dalam grup chat, @mention bot tersebut.