AI应用MCP工具调用方案结构化提示词

角色定义与任务定位
你应以AI系统架构师或提示词工程师的身份使用本方案。核心目标：设计一套严格执行MCP（Model Context Protocol）工具调用规范的结构化提示词，使AI能够根据用户输入的行业任务自动识别所需工具、组装调用参数、处理返回结果，并最终输出符合业务逻辑的应答。你的任务是将抽象的“工具调用”需求转化为指令清晰、字段完整、边界明确的提示词文本，便于直接嵌入AI应用的后端或前端交互流。

适用场景

在AI助手（如客服、数据分析助手、自动化工作流引擎）中，需要动态调用外部API、数据库、脚本或第三方服务时。
行业应用（金融、医疗、供应链、智能办公）中，需要将用户自然语言拆解为多步骤工具链调用时。
需要统一管理工具注册、参数校验、超时重试与错误反馈的复杂对话系统。


核心提示词
以下为可直接复制使用的结构化提示词框架，请根据实际工具名称与参数替换方括号内的内容：

系统角色声明：你是一个严格遵循MCP协议的工具调用代理。所有输出必须包含“tool_call”与“response”两个层级，且“tool_call”不能为空除非用户任务无需任何工具。
工具清单：当前可用的工具如下——工具名称：[tool_name]；用途：[short_desc]；输入参数：[参数1名称]（类型：[type]，描述：[desc]）；返回格式：[如JSON/String]；示例调用：[{“tool”:”工具名”,”args”:{}}]。
调用约束：①调用前必须验证参数完整性，缺失参数需用“ask_for_arg”标记向用户追问；②一次只能发起一个工具调用，待收到返回结果后再规划下一步；③若工具返回错误代码，需用“error_handler”字段包裹错误信息并提供降级策略。
结构化输出格式：请严格按以下JSON输出——{“thought”:”解释为何选择该工具”,”tool_call”:{“tool”:”工具名”,”args”:{对象}},”response”:{“status”:”pending”}}。等待返回后继续对话。


风格方向

技术精确风：指令零歧义，参数类型、枚举值、边界条件全部显式声明，避免模糊自然语言描述。
层级结构化：使用清晰的逻辑分段（工具清单→调用规则→输出模板→异常处理），每段用分隔标记或编号区分，便于解析器定位。
约束前置：将最高优先级的限制（如只能调用一个工具、必须等待返回）放在提示词最前部，减少模型偏离行为。


构图建议（信息架构方案）

决策流程图：将提示词对应的逻辑制作为“用户输入→意图识别→工具匹配→参数填充→调用→结果整合→响应”的横向流程图，辅助开发人员理解提示词中的判断节点（如“若参数不足则追问”）。
分栏对比表：针对不同类型工具（查询型、命令型、流式型），分别列出提示词中的差异化字段（如是否需要确认、是否支持异步返回），在文档中左右对比。
层级缩进排版：在提示词正文中使用逐级缩进（纯文本或Markdown风格的缩进）展示参数嵌套结构，例如args内嵌对象时使用增加一级缩进。


细节强化

参数类型声明：每个参数后附加“required|optional”及示例值，例如“amount（required，number，示例:1500.00）”。
时间与单位规范：如果工具涉及时间或度量单位，在提示词中硬编码统一格式（如“所有时间戳使用ISO 8601”）。
上下文记忆标记：添加“conversation_context”字段，确保后续调用能引用前序结果（例如将第一次调用的response中的id传入第二次调用）。
安全与权限：若工具需要身份验证，在提示词中增加“auth_required”标志并说明凭证获取方式（如从环境变量读取，不可由用户输入）。


使用建议

分步迭代测试：先在简单工具（如获取当前时间）上验证提示词结构，再逐步叠加行业业务逻辑。
错误日志注入：在提示词尾部加入“注：若工具调用失败，请记录error_id并返回用户提示：’系统暂时无法处理，请稍后重试’”，避免暴露内部细节。
动态工具注入：在AI应用启动时，将实际工具清单以变量形式拼接到提示词开头位置，保持提示词模板通用但工具列表可配置。
混合模态输出：如果行业应用需要同时返回文本和图表，在提示词中增加“output_format_switch”字段，例如支持“text”与“url”两种类型，由工具返回结果决定。