Agent Platform 提示词管理
用 Python 管理 Agent Platform 中的托管提示词。
证据显示对创建和删除设置了交互式确认、同轮限制，并提示使用 ADC；因此具备基本的变更控制。扣分原因是未说明最小 IAM 权限、数据流、敏感提示内容处理、依赖完整性或删除后的恢复方案，且认证命令可能影响用户环境。
证据显示覆盖 list、get、create、delete、版本和占位符，并给出部分幂等性说明。扣分原因是未提供测试、异常输入处理或可诊断错误反馈；创建示例的变量占位符语法与正文说明不完全一致，SDK 预览接口和未固定依赖版本也增加不确定性。静态审查不超过10分。
元数据清楚定义了提示管理场景及不适用的训练、部署和非 Agent Platform 提示。扣分原因是未明确输入输出契约、触发边界和非典型失败场景，也没有中文支持或中国大陆网络可达性说明。
证据显示文档分为主指南和创建参考，包含安装、示例、安全要求、许可证和 README 中的支持入口。扣分原因是缺少技能专属版本策略、变更日志、明确维护责任人、更新路径、FAQ 和系统化故障排查；依赖版本也未固定。
证据显示用户可获得用于列出、获取、创建和删除托管提示的 Python 片段，核心任务覆盖较完整。扣分原因是代码未经执行验证，创建参考较简短，缺少更新/版本管理的完整实现、错误处理和可直接复制运行的参数示例，因此仍可能需要较多人工核对。静态审查不超过7分。
证据包括源代码片段、操作约束和仓库 README/许可证，但没有提交测试、CI 覆盖或第三方执行结果。扣分原因是关键 SDK 行为、版本兼容性和示例正确性无法由所给文件独立复现；静态审查不超过5分。
- 不要将文档中的确认要求视为 IAM 最小权限或恢复能力的替代；删除前应确认资源范围并准备独立备份。
- 创建示例存在占位符语法不一致，且 SDK 为 preview、依赖未锁定；在生产使用前应核对当前 API 文档和版本。
- 文档未说明中国大陆网络可达性、中文交互或跨境数据处理风险。
这个 Skill 能做什么，适合哪些场景？
此技能面向需要管理 Agent Platform 托管提示词的开发者。它提供创建、列出、检索、版本读取和删除提示词的 Python SDK 指引。创建操作需要交互式确认，删除操作需要用户明确输入确认语句。使用前还需配置 Google Cloud ADC、Python 虚拟环境及相关 SDK。
指导用户使用 vertexai.preview.prompts，通过 vertexai.init 配置项目和区域；列出提示词及其显示名称和 ID；按提示词 ID 检索提示词并使用模板变量组装内容；读取指定版本；创建提示词时确认显示名称、模板文本和目标模型；删除提示词前要求输入提示词 ID及明确确认。它还要求使用大括号变量、记录生产提示词版本，并在相关 Dataset API 场景中使用正确的元数据结构。
- 需要查看某个 Google Cloud 项目中全部托管提示词的开发者。
- 需要按提示词 ID 获取模板并用变量组装内容的应用开发者。
- 需要为 Agent Platform 创建带目标模型和模板文本的新提示词的团队。
- 需要读取生产提示词版本并记录版本 ID 的维护者。
- 需要删除过时提示词资源、同时降低误删风险的管理员。
这个 Skill 有哪些优点和局限？
- 覆盖托管提示词的创建、查询、版本读取、组装和删除流程。
- 对创建与删除设置了分级确认机制，尤其强调删除不可逆。
- 提供可直接改写的 Python SDK 示例和环境初始化步骤。
- 明确排除模型训练、端点部署及非 Agent Platform 提示词管理。
- 依赖 Google Cloud 身份认证、项目和区域配置。
- 示例使用 vertexai.preview.prompts，来源未说明其稳定性或版本兼容范围。
- 创建提示词的详细代码未包含在给定材料中。
- 来源未提供测试套件、成本说明或失败场景的完整处理方式。
如何安装这个 Skill？
运行 npx skills add google/skills，并在交互选择中安装 skills/cloud/agent-platform-prompt-management。仓库整体采用 Apache-2.0 许可证，包含约 90 个技能；本条目仅对应上述路径。
如何使用这个 Skill？
先运行 gcloud auth login 和 gcloud auth application-default login，创建并激活虚拟环境：python3 -m venv ~/prompt_agent_venv，随后运行 source ~/prompt_agent_venv/bin/activate，再执行 pip install google-cloud-aiplatform google-genai。每次运行 Python 代码前都要激活该环境。可用触发语句：列出 Agent Platform 中项目 PROJECT_ID、区域 LOCATION_ID 的托管提示词。创建和删除前必须在新一轮对话中完成相应确认；删除代码不会在确认前提供。具体创建代码位于未提供的 references/create.md，因此此处不补充未给出的步骤。