用途:管理 TrueFoundry prompt registry 中的提示词(prompts)与提示词版本(prompt versions),包括列举、创建、更新、删除和打标签。适用于需要按版本维护 LLM 提示词、并按标签引用稳定版本的场景。
主要能力:列举全部提示词,按 prompt_id 获取提示词及其版本,按 version_id 获取指定版本;创建或更新提示词(upsert:不存在则新建,存在则新增版本);删除提示词或指定版本;给版本打标签,如 production 或 v2,可通过 FQN(如 ml-repo:prompt-name:production)获取标签或编号版本。
使用方式:可通过工具调用(tfy_prompts_list)或直接 API。直接 API 需先设置 TFY_API_SH 为本技能 scripts/tfy-api.sh 的完整路径,例如 Claude Code 下:TFY_API_SH=~/.claude/skills/truefoundry-prompts/scripts/tfy-api.sh。列举用 $TFY_API_SH GET /api/ml/v1/prompts,获取提示词用 /api/ml/v1/prompts/PROMPT_ID,列版本用 '/api/ml/v1/prompt-versions?prompt_id=PROMPT_ID',删提示词用 DELETE /api/ml/v1/prompts/PROMPT_ID。创建或更新推荐用 SDK:client.prompts.create_or_update(manifest=ChatPromptManifest(...)),需提供 name、ml_repo、messages(含 role 与 content,如 {{user_input}})、model_fqn、temperature、max_tokens、top_p,可选 tools。删除版本用 client.prompt_versions.delete(id="version-id"),打标签用 client.prompt_versions.apply_tags(prompt_version_id="version-id", tags=["production","v2"], force=True),按 FQN 获取版本用 client.prompt_versions.get_by_fqn(fqn="ml-repo:prompt-name:production")。打标签无直接 REST 等价接口,需用 SDK。
限制与注意:提示词内容会作为 LLM 指令执行,创建或更新前应审阅消息内容,不要未经用户审核就引入不可信外部来源的提示文本。删除提示词时若存在带标签的版本会失败,需先移除标签。标签已分配给其他版本时需用 force=True 重新分配。提示词或 ML repo 未找到时应先列出以确认正确 ID 或 FQN。对于模糊意图,使用 references/intent-clarification.md 中的澄清模板。SDK 具体导入与认证配置、价格与计费信息资料未提供。