如何在保险应用中从React向Dialogflow ES传参并实现个性化响应

一、直接通过Detect Intent API传递会话参数（推荐方案） #

相比上下文，直接在API请求中传入会话参数是更可靠的方式，步骤如下：

1. Dialogflow ES端配置

   • 打开欢迎意图，在「参数」板块添加accountId参数，类型选@sys.any（或根据实际需求自定义类型），无需设置实体匹配。
   • 在意图的响应文本中，用#accountId引用该参数，例如设置响应为Welcome #accountId。
   • 若想精准触发欢迎意图，可创建一个WELCOME_EVENT事件并关联到欢迎意图，避免文本匹配的不确定性。

2. React端调用API实现传参
   生产环境建议通过保险公司后端代理调用Dialogflow API（避免前端暴露服务密钥），以下是核心代码示例：

   import { SessionsClient } from '@google-cloud/dialogflow';
   
   // 初始化客户端（后端环境中通过环境变量配置密钥）
   const dialogflowClient = new SessionsClient({
     credentials: JSON.parse(process.env.DIALOGFLOW_SERVICE_ACCOUNT)
   });
   
   // 封装调用函数
   async function getPersonalizedGreeting(userId, accountId) {
     // 生成唯一会话ID（用用户ID保证会话隔离）
     const sessionPath = dialogflowClient.projectAgentSessionPath(
       '你的Dialogflow项目ID',
       userId
     );
   
     const request = {
       session: sessionPath,
       // 用事件触发欢迎意图，比文本更可靠
       queryInput: {
         event: {
           name: 'WELCOME_EVENT',
           languageCode: 'zh-CN'
         }
       },
       // 传入会话参数
       queryParams: {
         sessionParams: {
           accountId: accountId // React端获取的用户账户ID
         }
       }
     };
   
     const responses = await dialogflowClient.detectIntent(request);
     const fulfillmentText = responses[0].queryResult.fulfillmentText;
     // 将结果返回给React组件渲染
     return fulfillmentText;
   }
   
   // React组件中调用示例
   // getPersonalizedGreeting('用户唯一ID', 'ABC').then(text => setGreeting(text));
   

二、修正上下文传参的错误（若坚持使用Context） #

如果之前用上下文传参失败，大概率是上下文配置或时机问题：

• React端请求时携带上下文：

  const request = {
    session: sessionPath,
    queryInput: {
      text: { text: '欢迎', languageCode: 'zh-CN' }
    },
    queryParams: {
      contexts: [
        {
          name: `${sessionPath}/contexts/account-context`,
          lifespanCount: 3, // 设置上下文存活轮次
          parameters: { accountId: 'ABC' }
        }
      ]
    }
  };
  

• Dialogflow端配置：在欢迎意图的「输入上下文」中添加account-context，然后在响应中直接使用#accountId即可提取参数。

三、关键注意事项 #

• 会话隔离：必须为每个用户分配唯一的会话ID，防止参数串入其他用户的会话。
• 安全防护：绝对禁止在前端代码中硬编码Dialogflow服务账户密钥，必须通过后端代理转发请求。
• 参数校验：可在Dialogflow中为accountId参数设置校验规则，确保传入的账户ID格式合法。

内容的提问来源于stack exchange，提问作者Ruby Moore