排查智能体无法调用插件，需检查提示词是否明确定义插件能力、触发条件、参数约束及失败兜底逻辑，并提供标准调用示例。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
排查智能体无法调用插件的问题，关键在于检查 Agent Space 提示词中是否正确定义了插件能力、调用条件和参数约束。提示词不是越长越好，而是要让模型清晰理解“什么时候该用哪个插件、传什么参数、失败时怎么反馈”。
明确声明插件能力与触发意图
模型不会自动推断插件用途。必须在系统提示词中用简洁语言说明每个插件的功能边界和典型触发场景。
- ✅ 正确写法：“你可调用「查天气」插件获取指定城市当前温度、湿度和天气状况；当用户问‘今天北京热不热’‘上海现在下雨吗’这类含地点+实时天气意图的句子时，必须使用该插件。”
- ❌ 模糊写法：“你可以使用插件获取信息。”（未指明插件名、输入格式、触发信号）
严格约束参数格式与必填项
插件调用失败常因参数缺失、类型错误或命名不一致。提示词中需显式定义参数规则：
- 列出每个参数是否必填、合法值范围（如 city 必须是中文城市名，不能是“北上广”或坐标）
- 要求模型在调用前自行校验：若用户没给城市，应主动追问，而非传空值或猜测
- 避免使用模糊代词：“它”“这个”“那边”等不能作为参数值，提示词中要强调“必须提取明确实体”
定义插件调用失败的兜底逻辑
模型遇到插件返回错误（如超时、404、字段缺失）时，容易静默失败或胡乱编答案。提示词中需规定响应方式：
- 若插件返回空/报错，必须如实告知用户“暂时无法获取天气信息”，并说明可能原因（如城市名不支持、服务暂不可用）
- 禁止自行补全结果（如把“查不到北京天气”改成“北京今天25度”）
- 可加一句：“你没有权限伪造插件结果，所有事实性信息必须来自插件返回”
提供最小可行调用示例（Few-shot）
在提示词末尾加入1–2个标准调用范例，比纯文字描述更有效：
- 用户：“广州明天会下雨吗？” → 你调用「查天气」插件，参数：{"city": "广州", "date": "明天"}
- 用户：“帮我订一张去杭州的机票” → 你不调用「查天气」，因为意图不匹配，应引导至其他插件或说明能力边界
