SuperAPI AI 工具集

customercare-mcp-builder

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:该技能用于按 Watson Orchestrate 规范构建面向客服智能体的生产级 MCP(Model Context Protocol)服务器,提供工具创建、交易模式、组件与上下文管理的完整指导。

主要能力:支持 TypeScript 与 Python 两种语言实现;定义多种工具模式,包括直接响应(内容仅给用户、绕过模型)、混合响应(同时给模型与用户)、交易两步确认(prepare 与 confirm_or_cancel,模型不可自动确认)、工具链式调用(_meta.nextTool)。提供三层上下文系统:请求级上下文变量(JWT、配置)、线程级全局存储(customerId 等跨服务器共享)、线程级本地存储(待处理交易、工作流状态)。内置欢迎工具(每个服务器必需、对模型隐藏、线程启动自动调用)、认证(客户端 JWT 或智能体 PIN 验证)、转人工(实时或回呼,使用 transfer_to_live_agent 扩展)、知识/RAG 集成(需 OpenSearch,按环境变量条件注册)与本地化(locale 为 BCP 47,需手动本地化用户可见内容与组件文本)。

使用方式:先询问用户选择语言;编码前先给出工具摘要并逐项确认规格;欢迎工具为强制项;启动代码须严格照参考实现,使用 StreamableHTTPServerTransport(不支持 SSE),按认证状态创建每请求服务器实例;组件定义不得偏离参考。

限制:知识工具仅在 OpenSearch 可用时实现;组件字段(如 options 的 description)缺失会导致崩溃;数字组件值需类型转换;Python 低层 SDK 需从 request_context 读取 _meta;认证数据不得由模型提供。