结构化AI应用私有化部署文档提示词

角色定义与任务定位

请以“AI解决方案技术文档工程师”或“企业级AI产品部署专家”的身份，执行以下核心任务：你的目标是生成一份逻辑严谨、步骤清晰、可操作性强的《AI应用私有化部署文档》。这份文档旨在指导企业IT团队或客户技术部门，在本地或私有云环境中，安全、高效地完成AI应用的安装、配置、验证与维护，确保部署过程标准化且风险可控。

适用场景

• 为企业内部使用的AI工具（如智能客服、内容审核、数据分析模型）编写部署手册。
• 为交付给客户的私有化AI产品提供标准技术文档。
• 为DevOps团队编写自动化部署脚本（如Ansible, Docker Compose）的配套说明。
• 在技术投标、方案宣讲中，展示专业、细致的部署能力与售后支持规划。

核心提示词

以下提示词组合可直接或稍作修改后用于文档生成：

• “撰写一份详细的[AI应用名称]私有化部署指南，涵盖从环境检查、依赖安装、配置文件修改、服务启动到健康检查的全流程。”
• “以Markdown格式输出，包含以下章节：1. 概述与前提条件；2. 硬件与软件环境要求；3. 部署步骤详解（含命令与截图位置说明）；4. 配置项说明（核心参数表）；5. 服务验证与监控；6. 常见故障排查（FAQ）；7. 升级与回滚方案。”
• “生成一个Docker Compose部署[特定AI模型服务]的示例文件，并附上关键环境变量（如API密钥路径、模型存储路径、GPU支持）的配置说明。”
• “对比单机部署与集群化高可用部署两种方案的架构图描述、资源需求差异与实施步骤要点。”

风格方向

• 专业严谨：采用技术文档的客观、准确口吻，避免营销性语言。使用“必须”、“建议”、“可选”等明确措辞。
• 结构化与模块化：文档结构层次分明，大量使用编号列表、项目符号、表格（在提示词中描述表格内容）来组织信息。
• 面向操作：风格应侧重于指导行动，每个步骤都应具备可执行性，提供明确的命令、路径、参数示例。
• 风险提示：在关键操作步骤（如数据迁移、权限设置）前后，明确提示操作风险及回退方法。

构图建议（文档结构视觉化）

将文档整体想象为一个由核心向外扩展的架构图，在提示词中可引导生成如下结构描述：

• 中心核心：部署总览与目标。
• 第一层（基础环）：环境准备（操作系统、依赖库、网络/存储策略）。
• 第二层（执行环）：核心部署流程（获取安装包/镜像 -> 配置 -> 初始化 -> 启动）。
• 第三层（验证环）：服务验证（API调用测试、管理后台访问、日志检查）。
• 外层扩展区：高级主题（性能调优、监控告警集成、备份恢复、扩缩容方案）。

细节强化

• 配置参数表：提示生成包含“参数名”、“默认值”、“说明”、“是否必填”、“修改影响”列的配置表格。
• 命令与输出示例：关键命令行需提供示例，并描述预期成功输出或关键错误信息特征。
• 路径与权限：明确所有涉及的目录路径、文件所有权及建议的权限设置（如chmod 600, chown user:group）。
• 端口与网络：列出所有需要开放的防火墙端口、服务监听地址，并说明内部通信关系。
• 依赖版本精确化：指定关键依赖（如Python, CUDA, Docker）的具体版本号或版本范围。

使用建议

• 将“核心提示词”中的任一模板作为与AI对话的起点，并根据实际应用名称和技术栈替换方括号[]内的内容。
• 在生成长篇文档时，可采用“分章节生成”策略：先让AI输出大纲，再针对复杂章节（如“故障排查”）单独提供更详细的提示词进行深化。
• 提示词中应明确要求“避免使用模糊的代词”，直接引用组件名、文件名，例如用“修改`config.yaml`中的`model_path`变量”代替“修改它的配置文件”。
• 为提升文档实用性，可在提示词末尾追加要求：“在每一步中，标明该步骤预计耗时、是否需要重启服务、以及验证该步骤是否成功的方法”。