SuperAPI AI 工具集

truefoundry-prompts

智能体与模型

查看项目

更新于 10-16 06:15

技能介绍

用途:在 TrueFoundry Prompt Registry 中管理提示词,适用于列出提示词、查看版本、创建提示词、通过新建版本更新提示词、为版本打标签(例如 production)、获取提示词版本 FQN 供 Gateway 使用,以及生成代码片段或使用指引。创建或编辑智能体不在此技能范围,应使用 truefoundry-agents。

使用前准备:确认 tfy 登录已完成,否则使用 truefoundry-onboard;确认目标租户;确认提示词所在的 ML 仓库或提示词仓库;破坏性操作仅提供仪表盘指引。

界面路径:TrueFoundry Dashboard -> AI Gateway -> Prompt Management / Prompt Registry,适合可视化创建、比较或测试提示词。

主要能力与路径:列出提示词(API 或 UI,展示名称、ID、最新版本与标签);查看版本(API、SDK 或 UI,含版本 ID/FQN 与标签);创建提示词(SDK 或 UI,创建前复核消息与设置);更新提示词(SDK 或 UI,视为新版本,不静默覆盖);打标签(SDK 或 UI,移动 production 等稳定标签前需确认);获取 FQN(SDK 或 UI,供 Gateway 与 Agent 引用)。

API 回退示例:TFY_API_SH=~/.claude/skills/truefoundry-prompts/scripts/tfy-api.sh 后执行 $TFY_API_SH GET /api/ml/v1/prompts。

创建或更新需收集:提示词名称、仓库/ML 仓库、system 与 user 消息、变量、模型(若提示词存储模型)、temperature/top-p/max tokens(如需要)。创建或更新前展示最终提示词内容与设置。SDK 形态使用 ChatPromptManifest 与 client.prompts.create_or_update。

版本与标签:编辑提示词会创建版本,使用 production 或 staging 等标签提供稳定引用。应用标签前展示当前标签目标,稳定或面向生产的标签需明确确认。SDK 形态使用 client.prompt_versions.apply_tags。

获取 FQN:通过 UI 或 SDK,例如 client.prompt_versions.get_by_fqn(fqn="ml-repo:prompt-name:production"),FQN 用于 Gateway 提示词运行流程与 TrueFoundry Agents。

限制:不要从智能体删除提示词或提示词版本;如需删除,引导用户前往 Prompt Registry UI。智能体编写应转交 truefoundry-agents。