高效智能体开发运维脚本编写提示词
本提示词方案专为智能体开发与运维工程师设计,提供一套结构化、可落地的脚本编写指导框架。
提示词内容
复制角色定义与任务定位
请以“智能体架构师与高级运维工程师”的身份,运用本提示词方案。您的核心目标是:为智能体(AI Agent)的自动化运维、部署、监控与自愈流程,编写出高效、健壮、可维护的专业级脚本。您的产出不是简单的代码片段,而是支撑智能体稳定运行与持续进化的关键基础设施。
适用场景
- 为智能体设计自动化部署与更新流水线脚本。
- 编写智能体运行状态监控、日志收集与异常告警脚本。
- 开发智能体与外部API、数据库或消息队列交互的集成脚本。
- 创建用于智能体知识库更新、模型热加载或配置管理的维护脚本。
- 实现智能体在多环境(开发/测试/生产)下的资源调度与自愈脚本。
核心提示词
以下为可直接组合使用的提示词模块,请根据具体任务选取并组合:
- 基础框架:编写一个用于 [智能体名称/功能模块] 的 [Python/Bash/Shell] 脚本,主要功能是 [具体功能,如:每日定时清理过期日志文件]。
- 错误处理:脚本需包含完善的错误捕获与重试机制,使用 try-catch/信号处理,记录错误到指定日志文件,并在失败时通过 [邮件/Webhook] 发送告警。
- 配置管理:从外部配置文件(YAML/JSON)或环境变量中读取关键参数(如API端点、密钥、路径),确保脚本的可配置性与安全性。
- 状态检查:在脚本中集成对智能体核心服务(如模型API、数据库连接)的健康检查,返回明确的成功/失败状态码。
- 日志规范:采用结构化日志输出(JSON格式),包含时间戳、日志级别、脚本名称、执行步骤和关键上下文信息,便于后续分析。
风格方向
- 代码风格:遵循 PEP 8(Python)或 ShellCheck 准则,代码结构清晰,函数模块化,注释简明扼要。
- 文档风格:脚本开头包含标准的“脚本头”,说明用途、作者、参数、示例及变更历史。
- 输出风格:控制台输出简洁、信息明确,成功/警告/错误信息使用颜色或前缀区分(如 [INFO], [ERROR])。
构图建议
此处的“构图”指脚本的逻辑结构与流程设计:
- 分层结构:采用“初始化配置 -> 定义核心函数 -> 主流程控制 -> 清理与退出”的清晰层次。
- 流程控制图:在复杂脚本中,使用流程图思维,明确条件分支、循环和异常处理路径,确保逻辑无死角。
- 接口设计:若脚本作为智能体的一个组件,需明确定义输入参数、输出结果和调用接口,保持低耦合。
细节强化
- 安全性:避免在脚本中硬编码敏感信息;对用户输入进行验证和转义;使用最小权限原则执行命令。
- 性能:对于批量操作,考虑使用异步或多线程处理;合理设置超时和资源限制。
- 可观测性:在关键步骤输出度量指标(如执行耗时、处理记录数),方便接入监控系统(如Prometheus)。
- 兼容性:明确标注脚本运行依赖的环境(如Python版本、操作系统、必需的系统工具)。
使用建议
- 将上述“核心提示词”模块像积木一样组合,向您的代码生成AI助手(如GitHub Copilot、ChatGPT等)提出具体、完整的指令。
- 在生成代码后,务必进行代码审查、安全扫描和在隔离环境中的测试,特别是涉及系统级操作的脚本。
- 建议将成熟的脚本纳入版本控制系统,并配合CI/CD管道进行自动化测试与部署,形成智能体运维资产。
- 本方案是起点,请根据您智能体的具体技术栈(Docker、Kubernetes、云原生服务等)进一步细化提示词。