You need to enable JavaScript to run this app. 如何在React中为Azure QnA Bot构建自定义UI并实现安全调用
优惠活动
大模型
产品
解决方案
定价
更多

如何在React中为Azure QnA Bot构建自定义UI并实现安全调用

完整实现流程(从Token生成到React接入)

核心原则:Bot密钥绝对不能泄露到前端静态代码里,必须通过后端服务生成临时访问Token,前端仅调用后端接口获取Token后再初始化Web Chat组件,全程不会暴露密钥。

1. 后端生成临时Token(以Node.js为例,其他后端语言逻辑一致)

// 后端接口逻辑,注意把这部分部署在你的服务端,绝对不要暴露给前端
const axios = require('axios');
const BOT_SECRET = '你在Azure Portal获取的Bot密钥';
const BOT_ID = '你的Azure Bot ID';

// 给前端暴露的获取Token接口
async function getBotToken(req, res) {
  try {
    const response = await axios.post(
      'https://webchat.botframework.com/api/tokens',
      {},
      {
        headers: {
          Authorization: `Bearer ${BOT_SECRET}`,
          'Content-Type': 'application/json'
        }
      }
    );
    // 返回临时Token给前端,这个Token有效期1小时
    res.json({ token: response.data });
  } catch (err) {
    res.status(500).json({ error: '获取Token失败' });
  }
}

2. React前端集成botframework-webchat

首先安装依赖:
npm install botframework-webchat 或者 yarn add botframework-webchat

组件代码示例:

import React, { useState, useEffect } from 'react';
import ReactWebChat from 'botframework-webchat';

const QnAChatBot = () => {
  const [token, setToken] = useState('');

  // 组件挂载时从自己的后端获取Token,不要直接调用Azure的Token接口!
  useEffect(() => {
    const fetchToken = async () => {
      try {
        // 这里调用你自己后端的Token接口,不是直接调用Bot Framework的接口
        const res = await fetch('/api/get-bot-token');
        const data = await res.json();
        setToken(data.token);
      } catch (err) {
        console.error('获取Bot Token失败', err);
      }
    };
    fetchToken();
  }, []);

  return (
    <div style={{ height: '600px', width: '400px' }}>
      {token ? (
        <ReactWebChat
          directLine={{ token }}
          // 可以自定义样式、用户ID、用户名等参数
          userID='自定义用户ID'
          username='访客'
        />
      ) : (
        <p>聊天组件加载中...</p>
      )}
    </div>
  );
};

export default QnAChatBot;
注意事项
  • 生成的临时Token有效期为1小时,可根据业务需求增加定时刷新逻辑,在Token过期前重新调用后端接口获取新Token替换即可
  • 后端的Token获取接口建议增加权限校验,比如校验用户登录态,避免接口被恶意调用消耗Bot服务配额
  • 本地调试阶段如果暂时没有后端,可以临时用脚本本地生成Token复制到前端测试,正式上线必须走后端生成Token的逻辑,绝对不能把Bot密钥硬编码在前端代码或者构建产物里

内容的提问来源于stack exchange,提问作者Sharvani

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 19:36:10