基于IBM watsonX与BAW搭建API驱动对话系统的技术问询

一、适用的watsonX服务类型 #

1. watsonx.ai 基础模型API（Foundation Models） #

如果仅需实现单轮问题-生成式响应的核心逻辑，不需要复杂对话管理（如多轮上下文维护、意图识别），这是最优选择。它支持Granite、Llama 2等主流大模型，完全通过REST API交互，完美适配BAW发起请求的场景。

2. watsonx Assistant #

如果对话系统需要多轮对话、意图识别、实体提取，或要与BAW的业务流程深度联动（比如根据对话结果触发BAW中的审批/流转逻辑），则选择watsonx Assistant更合适。它提供的API可维护对话上下文，支持复杂对话场景的扩展。

二、API暴露与BAW对接流程 #

针对watsonx.ai基础模型的实现步骤 #

1. 生成IAM API密钥
   在IBM Cloud控制台找到watsonx.ai服务实例，创建并保存专属的IAM API密钥，用于后续生成访问令牌。
2. 获取Bearer访问令牌
   通过IAM令牌服务换取访问令牌，BAW可通过内置的HTTP请求节点执行此步骤：

   curl -X POST "https://iam.cloud.ibm.com/identity/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=YOUR_API_KEY"
   

3. 调用模型推理API
   BAW发起POST请求到watsonx.ai的推理端点，请求体示例：

   {
     "model_id": "ibm/granite-13b-chat-v1",
     "input": "用户的具体问题",
     "parameters": {
       "max_new_tokens": 500,
       "temperature": 0.7
     }
   }
   

   请求头需包含Authorization: Bearer YOUR_ACCESS_TOKEN和Content-Type: application/json，返回结果中提取results[0].generated_text作为回答内容。

针对watsonx Assistant的实现步骤 #

1. 配置对话技能
   在watsonx Assistant控制台创建对话技能，可选择配置意图/实体规则，或直接关联基础模型实现生成式回答。
2. 获取服务凭证
   在服务实例的API详情页，获取助理ID、版本ID和IAM API密钥。
3. 调用对话API
   BAW发起POST请求到对话端点，示例请求体：

   {
     "input": {
       "text": "用户的具体问题"
     },
     "context": {
       "global": {
         "system": {
           "user_id": "用户唯一标识"
         }
       }
     }
   }
   

   端点格式为https://api.us-south.assistant.watson.cloud.ibm.com/instances/{INSTANCE_ID}/v2/assistants/{ASSISTANT_ID}/sessions/{SESSION_ID}/message?version=2023-07-18，请求头同样需携带Bearer令牌，返回结果中提取output.generic[0].text作为回答内容。

BAW侧核心配置 #

• 在BAW流程中添加REST服务调用节点，配置watsonX的API端点、动态生成的Bearer令牌请求头，以及符合要求的JSON请求体。
• 解析watsonX返回的JSON响应，提取回答字段后传递给客户交互节点。

内容的提问来源于stack exchange，提问作者Oshenth Jayathilake