用途:通过 ibl.ai 平台 API 管理某个智能体的提示词,包括内置的 system/proactive/study/guided 提示词和问候设置,以及对智能体“建议提示词”的创建、更新、删除。适用于编辑智能体说什么、建议什么。
认证与约定:基础地址 https://api.iblai.app;每个请求都需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org} = $IBLAI_ORG,{username} = $IBLAI_USERNAME,{mentor} = 智能体唯一 id。设置类写入统一走 PUT …/users/{username}/mentors/{mentor}/settings/,只发送被修改的字段。若尚未连接,先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取:GET …/mentors/{mentor}/settings/ 获取 system/proactive/study/guided 提示词文本、greeting_method、enable_guided_prompts;GET …/prompts/?mentor={mentor}&limit=6&offset={n}&order_direction=asc 列出建议提示词;GET …/prompts/category/ 获取提示词分类。
写入:PUT …/mentors/{mentor}/settings/ 更新内置提示词(一次只发一个键,如 system_prompt、proactive_prompt、study_mode_prompt、guided_prompt_instructions);同一端点可更新 greeting_method(PROACTIVE_PROMPT|PROACTIVE_RESPONSE)与 enable_guided_prompts(布尔)。建议提示词的创建用 POST …/prompt/(prompt 必填,另有 category、is_system、mentor、platform、prompt_visibility);更新用 PUT …/prompt/{id}/;删除用 DELETE …/prompt/{id}/(无请求体)。
限制与注意:内置提示词与问候开关通过 settings/ 保存,只发送变更键,不要发整个对象;建议提示词是 ai-prompt/…/prompt/ 下的独立资源;建议提示词列表端点分页,需用 limit 和 offset 翻页。资料未提供速率限制、错误码及权限范围的更多细节。