交接说明明确agent space agent的运行、调试与维护方法：涵盖启动入口、配置文件、提示词模板、工具函数、依赖清单及部署配置；敏感依赖需单独标注；提供本地与容器化验证步骤；要求补全关键逻辑注释与提示词约束；附三组测试用例及预期响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
为Agent Space Agent编写交接说明，需确保接手人能独立运行、调试和维护该智能体，避免因信息缺失导致服务中断或逻辑错乱。
明确交接范围与边界
先列出本次交接涉及的全部模块：包括Agent启动入口文件、配置文件（如config.yaml）、提示词模板（prompt_template.jinja2）、工具调用函数（tools/目录下所有.py文件）、依赖清单（requirements.txt）及部署环境说明（Dockerfile或systemd service配置）。【未列入清单的代码或配置，接手人无义务维护】
检查当前Agent是否依赖私有API密钥、内网服务地址或临时挂载的模型路径——这些必须单独标注在“敏感依赖”小节中，不可写死在代码里。
提供可立即验证的运行路径
方法一：本地快速启动验证
进入项目根目录→执行 python main.py --env dev →观察控制台是否输出“Agent ready, listening on http://localhost:8000”且无ModuleNotFoundError或KeyError。若报错，优先检查 .env 文件是否存在且已填入 OPENAI_API_KEY。
方法二：容器化部署验证
执行 docker build -t agent-space-dev . → docker run -p 8000:8000 --env-file .env agent-space-dev →curl http://localhost:8000/health 返回 {"status":"ok"} 即为成功。注意：【Docker镜像构建时不会自动复制 .env 文件，必须通过 --env-file 显式传入】
关键逻辑链路注释补全
第一步：打开 agents/router.py，找到 route_to_tool() 函数。
第二步：在每个 if/elif 分支上方，用单行注释说明该分支触发条件（例如：“# 当用户消息含‘查订单’且含12位数字时走此分支”），不要只写“处理订单查询”。
第三步：打开 prompts/agent_system.jinja2，将原模板中模糊的“请按需调用工具”改为具体约束，例如：“仅当用户明确要求‘重发验证码’‘冻结账户’或‘导出近7天流水’时才允许调用admin_tools；其余情况一律返回‘我暂不支持该操作’。”
这一步不能跳过——缺少上下文约束的提示词会导致Agent在测试中随机调用高危工具。
测试用例与预期响应对照表
在 tests/ 目录下新建 test_scenarios.md，按如下格式填写三组最小可行测试：
① 输入：“我的订单号是ORD-987654321，查下物流” → 预期调用 tools/logistics.py → 返回含“已签收，签收时间：2024-06-12 14:30”字段的JSON
② 输入：“把账号停用” → 预期拒绝调用任何tool → 返回“您的请求涉及账户操作，需联系人工客服处理”
③ 输入：“今天天气怎么样” → 预期触发 fallback 流程 → 返回“我专注处理订单与账户相关事务，暂不支持天气查询”
