laf简介

Tailchat 是一个开源的 noIM(not only IM) 应用,除了一般的即时通讯功能以外还包含完整的开放平台和插件生态。本次我们就要使用 Tailchat 的开放平台。

Laf 是一个开源的 Serverless 云开发,提供云函数、云数据库、云存储等开箱即用的应用资源。本次我们要用的是他提供的云函数。

因为这两个平台都非常方便,所以我们只需要 10 分钟就能开发一个完整的对话机器人。

laf创建开放平台应用

废话不多说,我们直接开干。

首先我们需要在 Tailchat 的开放平台中创建一个开放平台应用。

在创建前我们需要先安装相关的插件,因为 Tailchat 的能力都是封装在不同的插件中的,如果没有安装插件的话部分能力是不可见的。

我们需要安装开放平台插件 (com.msgbyte.openapi) 与第三方集成 (com.msgbyte.integration) 插件:

file

然后我们就能在左下角的设置页面看到我们的开放平台插件

快速创建一个应用 :

file

file

创建完毕后点击 Enter 进入应用详情页。

file

此时我们可以拿到两个东西,一个是 appid 用于标识 app 的唯一 id,一个是 appsecret 用于进行服务进行交互。可以简单理解为开放平台应用的账户名和密码。

点击小眼睛显示不脱敏的完整秘钥。这两个字段我们接下来要用到。

创建 Laf 云函数

接下来我们来创建云函数用于机器人的后台服务。

首先在 海外版 Laf 中登录 / 注册账号并创建一个应用。

Laf 为每个账号提供一个免费的实验应用可以用于快速尝试,我们直接创建免费的即可:

file

等待应用启动完毕后我们就可以直接在网页上进行代码的编写。

点击左上角加号创建一个云函数:

file

在左下角依赖中安装 Tailchat 官方提供的 tailchat-client-sdk 包用于快速开发:

file

点击保存后应用会自动重启,此时你的应用就相当于安装了这个包了。此时我们可以直接引入,如果包里面有 ts 的类型的话网页编辑器还会有类型提示。

点击函数快速写入如下内容 :

import { TailchatClient, stripMentionTag } from 'tailchat-client-sdk';

const host = '<your tailchat instance backend host>';
const appId = '<appId>';
const appSecret = '<appSecret>';

const client = new TailchatClient(host, appId, appSecret)

export async function main(ctx: FunctionContext) {
  console.log('receive', ctx.body);

  const type = ctx.body.type;
  if (type === 'message') {
    const payload = ctx.body.payload;
    try {
      const message = await client.replyMessage({
        messageId: payload.messageId,
        author: payload.messageAuthor,
        content: payload.messageSnippet
      }, {
        groupId: payload.groupId,
        converseId: payload.converseId,
        content: `Your message: ${stripMentionTag(payload.messageSnippet)}`,
      })

      console.log('send message success:', message)
    } catch (err) {
      console.log('send message failed:', err)
    }
  }

  return { data: 'hi, laf' }
}

在代码顶部的 host / appId / appSecret 分别填入对应的内容,其中 host 就是你自己部署的 Tailchat 后端的地址。如果你用的是官方的 nightly 环境可以直接填入 https://tailchat-nightly.moonrailgun.com

代码逻辑非常简单,就是接收来自 Tailchat 推送的消息,并将接收到的内容原样回复。

完成代码的编辑后点击右上角的发布按钮将代码发布到线上,同时也可以看到 laf 提供了一个可供外网访问的 url, 这个 url 需要记录一下我们之后会用到。

file

此时,我们的机器人服务就已经完成了。

机器人配置
这时我们回到 Tailchat 中。我们还有一些步骤尚未完成。

重新打开应用详情,切换到机器人标签。开启机器人功能并将我们在 laf 中拿到的 url 填入回调地址中:

file

然后把我们的机器人添加到群组中,在群组左上角打开详情:

file

在左边找到集成功能,输入 appid 找到应用,点击添加机器人到群组按钮。

file

此时我们在频道中 @ 机器人并输入内容后,就可以看到机器人进行了相应的回复:

file

自此,一个简单的对话机器人就完成了。

如果想要别的功能,直接修改机器人的源码即可。通过机器人我们可以让 Tailchat 与各种各样的服务进行连接。

引用链接
[1]
Tailchat: https://github.com/msgbyte/tailchat

[2]
Laf: https://github.com/labring/laf

[3]
海外版 Laf: https://laf.dev

关于 Laf
Laf 是一款为所有开发者打造的集函数、数据库、存储为一体的云开发平台,助你像写博客一样写代码,随时随地发布上线应用!3 分钟上线 ChatGPT 应用!

🌟GitHub:https://github.com/labring/laf

🏠官网(国内):https://laf.run

🌎官网(海外):https://laf.dev

💻开发者论坛:https://forum.laf.run
sealos 以kubernetes为内核的云操作系统发行版,让云原生简单普及

laf 写代码像写博客一样简单,什么docker kubernetes统统不关心,我只关心写业务!


sealyun
289 声望56 粉丝

技术填坑者,爬起来接着填