需配置备用连接地址并启用多线路BGP容灾机制：一、确认IMA支持多Endpoint与BGP通告；二、WorkBuddy中配置备用API地址及主备自动切换；三、通过环境变量注入BGP路由偏好参数；四、IMA侧配置BGP会话标签与路由标记；五、启用DNS多线路解析作为兜底。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已配置WorkBuddy连接IMA主服务，但希望增强可用性，防止单点故障导致AI能力中断，则需为其配置备用连接地址并启用多线路BGP容灾机制。以下是实现该目标的具体操作路径：
一、确认IMA服务端支持多Endpoint与BGP通告
WorkBuddy本身不运行BGP协议，其“多线路BGP容灾”能力依赖于后端IMA服务所部署的BGP机房架构。因此，必须先验证IMA服务是否已由运营商提供BGP双线接入，并对外通告多个可达IP地址（如主线路103.10.20.1/32、备用线路203.50.60.1/32），且两地址均指向同一逻辑服务集群。若IMA仅提供单一HTTP域名或固定IP，则无法实现BGP级自动切换。
1、访问 https://ima.qq.com/agent-interface 并登录管理员账号。
2、在「部署信息」或「网络配置」页签中查找「BGP ASN」、「通告前缀」、「可用接入点列表」字段。
3、确认存在至少两个不同网段的IPv4地址，且状态均为“已激活”和“BGP同步中”。
二、在WorkBuddy中配置备用IMA连接地址
WorkBuddy允许为同一技能设置主备连接地址，当主地址不可达时自动降级使用备用地址。该机制独立于BGP，属于客户端连接层容灾，可与BGP形成双重保障。
1、打开WorkBuddy主界面，点击左下角头像进入「Claw设置」。
2、在左侧导航栏选择「技能管理」，找到已安装的【ima笔记】技能，点击右侧「配置」按钮。
3、在弹出配置面板中，定位到「连接参数」区域，展开「高级网络设置」。
4、在「备用API地址」输入框中，粘贴从IMA控制台获取的第二个接入IP（例如：https://203.50.60.1:443/v1）。
5、勾选「启用主备自动切换」，并设置「健康检查间隔」为30秒、「连续失败阈值」为2次。
三、通过环境变量注入BGP路由偏好参数
若WorkBuddy运行在Linux服务器且该服务器直连BGP机房（如托管于腾讯云广州BGP机房），可通过设置内核级路由策略，使WorkBuddy进程优先走指定BGP线路。此操作不修改WorkBuddy代码，仅调整系统路由表行为。
1、以root身份执行：ip rule add from 172.16.10.50 table 100（假设WorkBuddy所在主机IP为172.16.10.50）。
2、执行：ip route add default via 103.10.20.254 dev eth0 table 100（指向主线路下一跳）。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
3、执行：ip route add default via 203.50.60.254 dev eth1 table 101（指向备用线路下一跳）。
4、创建策略路由规则：ip rule add to 103.10.20.1/32 table 100 和 ip rule add to 203.50.60.1/32 table 101。
5、重启WorkBuddy服务使路由策略生效。
四、配置IMA侧BGP会话标签与路由标记
为使IMA服务端能识别来自WorkBuddy的流量并实施差异化路由调度，需在IMA侧BGP配置中对WorkBuddy出口IP段打上Community标签。此步骤需IMA运维人员配合完成，WorkBuddy端仅需提供源IP范围。
1、在WorkBuddy所在服务器执行：ip addr show | grep "inet " | grep -v "127.0.0.1"，记录所有公网出口IP及子网（如103.10.20.50/32）。
2、将该IP清单提交至IMA技术支持团队，要求其在BGP导出策略中添加：set community 65001:100（示例标签）。
3、要求IMA在路由反射器上配置匹配该Community的import filter，将带标签流量导向高SLA专线通道。
4、验证标签生效：在WorkBuddy服务器执行 curl -v https://103.10.20.1/health，观察响应头中是否含 X-Route-Tag: 65001:100。
五、启用DNS层面的多线路解析作为兜底方案
当BGP链路与客户端主备地址均失效时，DNS轮询可提供最基础的可用性保障。该方案无需IMA或WorkBuddy修改代码，仅依赖域名解析系统。
1、登录IMA服务绑定的DNS服务商控制台（如腾讯云DNSPod、阿里云云解析DNS）。
2、将IMA服务域名（如api.ima.qq.com）的A记录类型改为「智能解析」模式。
3、添加两条A记录：主线路指向103.10.20.1，线路类型设为「电信」；备用线路指向203.50.60.1，线路类型设为「联通+移动」。
4、设置TTL为60秒，确保故障发生后1分钟内DNS可刷新至备用IP。
5、在WorkBuddy技能配置中，将API地址由IP改为该域名：https://api.ima.qq.com/v1。
