Нулевой код: используйте Dify и Laf для подключения к корпоративному роботу WeChat AI за две минуты.

Исходная ссылка: https://docs.dify.ai/v/zh-hans/use-cases/integrate-with-wecom-using-dify.

Dify позволяет создавать приложения искусственного интеллекта и предоставляет дополнительные возможности разработки. Здесь я продемонстрирую создание AI-приложения для помощника по юридическим вопросам и ответам под названием «Жифа». В этом уроке я расскажу вам, как подключиться к корпоративному WeChat для «Жифы».

Подготовка

• Разрешения администратора для Enterprise WeChat
• Учетная запись Dify
• Облачный аккаунт Laf
• (Необязательно) Ключ API OpenAI. Если нет, вы можете бесплатно использовать 200 возможностей звонков, предоставляемых Dify, для тестирования.
• (Необязательно) Создайте новый файл env.txt на своем компьютере и скопируйте в него следующий контент. В следующем уроке мы шаг за шагом заполним соответствующую информацию в этот файл. Шаги, требующие сохранения информации, выделены.

WXWORK_TOKEN=""
WXWORK_AESKEY=""
WXWORK_CORPID=""
WXWORK_AGENTID=""
WXWORK_CORPSECRET=""
DIFY_APPTOKEN=""

Создать приложение на Dify

В этой главе будет описано, как создать набор данных юридических знаний и связать этот набор данных с приложениями.

Создайте набор данных юридических знаний

Дополнительные сведения о создании набора данных см. в документации в любое время: [Управление набором данных]

Чтобы «Знай закон» лучше понимал контекст, нам необходимо создать базу данных юридических знаний.

• **Импорт документов:**Импортируйте документы PDF с юридическими знаниями со своего компьютера.

• Сегментация и очистка текста . Загруженный текст должен пройти вторичную обработку, прежде чем его сможет понять большая языковая модель. Здесь нам не нужно обращать внимание на конкретную логику реализации, просто выберите автоматическую сегментацию, а затем нажмите «Сохранить и обработать».

• **Встраивание текста.** Примерно через 30 секунд набор данных будет успешно создан. Вы можете вернуться в любое время, чтобы добавить больше файлов в базу данных.

Встроенное приложение

Ознакомьтесь с документацией в любое время для получения дополнительных сведений о создании приложения [Создать приложение]

• **Создание приложения:** Согласно инструкции на картинке создайте диалоговое приложение и назовите его «Жифа».

• **Связанный набор данных:** На странице «Подсказка расположения слов» добавьте и выберите набор данных, который вы только что создали в модуле «Контекст».

• **Опубликуйте модель.** После завершения создания связанного набора данных нажмите «Опубликовать» в правом верхнем углу страницы, чтобы модель вступила в силу.

• **Получите ключ доступа к API. **На странице «Доступ к API» создайте ключ API, скопируйте и сохраните его как DIFY_APPTOKEN. Пожалуйста, будьте осторожны, чтобы не передать ключ кому-либо, чтобы избежать материального ущерба.

Создайте корпоративное приложение WeChat

• ** Запишите информацию о предприятии: ** Введите сведения об управлении предприятием WeChat — «Мое предприятие», запишите здесь идентификатор предприятия какWXWORK_CORPID

• **Создайте корпоративное приложение WeChat:** Войдите на страницу управления приложением, нажмите [Создать приложение], чтобы перейти на страницу создания, заполните информацию о приложении и нажмите [Создать приложение]. Если у вас уже есть существующее приложение, вы можете пропустить этот шаг.

• **Запишите информацию о корпоративном приложении WeChat.** Нажмите только что созданное приложение на странице управления приложением, чтобы перейти на страницу сведений о приложении. Запишите сюда AgentId и Secret (нужно нажать кнопку «Получить», чтобы получить их в окне корпоративного чата WeChat), которые представляют собой WXWORK_AGENTID и WXWORK_CORPSECRET соответственно.

• **Приложение Enterprise WeChat получает информацию:** На странице сведений о приложении нажмите [Настроить прием API] в области приема сообщений.

На странице получения сообщений API нажмите две кнопки [Получить в случайном порядке], которые автоматически сгенерируют токен и EncodingAESKey, которые мы записываем как WXWORK_TOKEN и WXWORK_AESKEY соответственно. Обратите внимание: не закрывайте эту страницу. Мы заполним URL-адрес после настройки стороны Laf.

Создание облачных функций в Laf Cloud

• **Создайте новое облачное приложение Laf.** После входа в Laf нажмите «Создать», чтобы создать облачное приложение. Просто выберите бесплатный план здесь.

• **Добавить зависимости.** Приложению Enterprise WeChat необходимо добавить @wecom/cryptoдве xml2jsзависимости. После добавления ваш список зависимостей должен выглядеть, как показано ниже.

• **Добавьте переменные среды.** Начиная со второй строки, вставьте сюда все содержимое, собранное на предыдущих шагах, и нажмите «Обновить».

• **Создать облачную функцию: **Нажмите, чтобы создать облачную функцию, обратите внимание, что установлен флажок «Метод запроса» POST, GETи нажмите «ОК».

После создания облачной функции удалите код по умолчанию и вставьте сюда весь код из «Приложения» в конце статьи.

• **Функция публикации в облаке.** После нажатия кнопки «Опубликовать» функция облака вступит в силу.

Теперь вставьте URL-адрес в пустое место слева на странице [Настроить прием API] серверной части Enterprise WeChat и нажмите «Сохранить».

• **Настройте белый список IP-адресов.** Найдите только что созданное приложение в WeChat Enterprise и отправьте сообщение. Как и ожидалось, никаких сообщений получено не было. Это связано с тем, что Enterprise WeChat по умолчанию блокирует IP-адрес Laf Cloud.

Нажмите на журнал, и вы увидите такую ​​ошибку ' not allow to access from your ip'

Нажмите, чтобы просмотреть подробную информацию об этом журнале и записать IP-адрес облака Laf, указанный в журнале.

Вернитесь к фону управления Enterprise WeChat, щелкните только что созданное приложение и настройте возможный IP-адрес для приложения.

Просто введите IP, записанный в журнале только что.

Проверить эффект

1. **Тестовый чат.** Найдите приложение, которое вы только что создали, в WeChat Enterprise и отправьте сообщение. Теперь вы сможете получать push-сообщения.

Цитировать

Эта подробная ссылка сделана на следующую статью, и я хотел бы поблагодарить автора за его тяжелую работу. https://forum.laf.run/d/556/3

приложение

Код корпоративного приложения WeChat — (ответ псевдопотоковой передачи)

import cloud from '@lafjs/cloud'
import { decrypt, getSignature } from '@wecom/crypto'
import xml2js from 'xml2js'

function genConversationKey(userName) {
  return `${process.env.WXWORK_AGENTID}:${userName}`
}

function genWxAppAccessTokenKey() {
  return `${process.env.WXWORK_AGENTID}:access-token`
}

async function getToken() {
  console.log('[getToken] called')

  const cache = cloud.shared.get(genWxAppAccessTokenKey())
  if (cache && cache.expires >= Date.now()) return cache.token

  const res = await cloud.fetch({
    url: 'https://qyapi.weixin.qq.com/cgi-bin/gettoken',
    method: 'GET',
    params: {
      corpid: process.env.WXWORK_CORPID,
      corpsecret: process.env.WXWORK_CORPSECRET,
    }
  })

  const token = res.data.access_token
  cloud.shared.set(genWxAppAccessTokenKey(), { token, expires: Date.now() + res.data.expires_in * 1000 })
  return token
}

async function sendWxMessage(message, user) {
  console.log('[sendWxMessage] called', user, message)

  const res = await cloud.fetch({
    url: 'https://qyapi.weixin.qq.com/cgi-bin/message/send',
    method: 'POST',
    params: {
      access_token: await getToken()
    },
    data: {
      "touser": user,
      "msgtype": "text",
      "agentid": process.env.WXWORK_AGENTID,
      "text": {
        "content": message
      },
      "safe": 0,
      "enable_id_trans": 0,
      "enable_duplicate_check": 0,
      "duplicate_check_interval": 1800
    },
  })
  console.log('[sendWxMessage] received', res.data)
}

async function sendDifyMessage(message, userName, onMessage) {
  console.log('[sendDifyMessage] called', message, userName)

  const conversationId = cloud.shared.get(genConversationKey(userName)) || null
  let newConversationId = ''
  let responseText = ''

  try {
    const response = await cloud.fetch({
      url: 'https://api.dify.ai/v1/chat-messages',
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.DIFY_APPTOKEN}`
      },
      data: {
        inputs: {},
        response_mode: "streaming",
        query: message,
        user: userName,
        conversation_id: conversationId
      },
      responseType: "stream"
    })

    let firstHalfMessage = ''
    response.data.on('data', (data) => {
      let message = data.toString()
      try {
        if (firstHalfMessage) {
          message += firstHalfMessage
          firstHalfMessage = ''
        }

        // 检查是不是sse协议
        if (!message.startsWith('data: ')) return

        const parsedChunk: Record<string, any> = JSON.parse(message.substring(6))

        if (!newConversationId) {
          newConversationId = parsedChunk.conversation_id
          cloud.shared.set(genConversationKey(userName), newConversationId)
        }
        const { answer } = parsedChunk
        responseText += answer

        // 伪流式响应
        if (answer.endsWith('\n\n') || (responseText.length > 120 && /[?。；！]$/.test(responseText))) {
          onMessage(responseText.replace('\n\n', ''))
          console.log('[sendDifyMessage] received', responseText, newConversationId)
          responseText = ''
        }
      } catch (e) {
        firstHalfMessage = message
        console.error('[sendDifyMessage] error', message)
      }

    })

    // stream结束时把剩下的消息全部发出去
    response.data.on('end', () => {
      onMessage(responseText.replace('\n\n', ''))
    })
  } catch (e) {
    console.error("[sendDifyMessage] error", e)
  }
}

async function asyncSendMessage(xml) {
  console.log('[asyncSendMessage] called', xml)

  if (xml.MsgType[0] !== 'text') return

  const message = xml.Content[0]
  const userName = xml.FromUserName[0]

  if (message === '/new') {
    // 重置conversation id
    cloud.shared.set(genConversationKey(userName), null)
    sendWxMessage('新建成功，开始新的对话吧~~', userName)
    return
  }

  sendWxMessage('AI思考中, 请耐心等待~~', userName)

  try {
    sendDifyMessage(message, userName, (message) => {
      sendWxMessage(message, userName)
    })
  }
  catch (e) {
    console.error('[sendDifyMessage] error', e)
    sendWxMessage('接口请求失败，请联系管理员查看错误信息', userName)
  }
}

export default async function (ctx: FunctionContext) {
  const { query } = ctx
  const { msg_signature, timestamp, nonce, echostr } = query
  const token = process.env.WXWORK_TOKEN
  const key = process.env.WXWORK_AESKEY
  console.log('[main] called', ctx.method, ctx.request.url)

  // 签名验证专用
  if (ctx.method === 'GET') {
    const signature = getSignature(token, timestamp, nonce, echostr)
    if (signature !== msg_signature) {
      return { message: '签名验证失败', code: 401 }
    }
    const { message } = decrypt(key, echostr)
    return message
  }

  const payload = ctx.body.xml
  const encrypt = payload.encrypt[0]
  const signature = getSignature(token, timestamp, nonce, encrypt)
  if (signature !== msg_signature) {
    return { message: '签名验证失败', code: 401 }
  }

  const { message } = decrypt(key, encrypt)
  const {
    xml
  } = await xml2js.parseStringPromise(message)
  // 由于GPT API耗时较久，这里提前返回，防止企业微信超时重试，后续再手动调用发消息接口
  ctx.response.sendStatus(200)

  await asyncSendMessage(xml)

  return { message: true, code: 0 }
}