用途:通过 ibl.ai 平台 API 管理某个智能体的提示词,包括内置的系统提示词、主动提示词、学习模式提示词、引导提示词,以及问候设置;同时可对智能体的建议提示词进行创建、更新和删除。适用于需要编辑智能体回复内容与推荐内容的场景。
认证与约定:基础地址为 https://api.iblai.app。每个请求都需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org} 对应 $IBLAI_ORG,{username} 对应 $IBLAI_USERNAME,{mentor} 为智能体唯一 id(例如 d17dc729-60fd-4363-81a0-f67d9318b03e)。设置类写入统一走一个端点 PUT …/users/{username}/mentors/{mentor}/settings/,只发送发生变化的字段。若尚未连接,先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取:GET …/users/{username}/mentors/{mentor}/settings/ 可获取 system / proactive / study / guided 提示词文本、greeting_method、enable_guided_prompts。GET https://api.iblai.app/dm/api/search/orgs/{org}/users/{username}/prompts/?mentor={mentor}&limit=6&offset={n}&order_direction=asc 列出建议提示词。GET https://api.iblai.app/dm/api/ai-prompt/orgs/{org}/users/{username}/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": "boolean"}。POST https://api.iblai.app/dm/api/ai-prompt/orgs/{org}/users/{username}/prompt/ 创建建议提示词,字段含 prompt(必填)、category、is_system、mentor、platform、prompt_visibility。PUT …/ai-prompt/orgs/{org}/users/{username}/prompt/{id}/ 更新建议提示词,字段含 prompt、category、is_system、prompt_visibility。DELETE …/ai-prompt/orgs/{org}/users/{username}/prompt/{id}/ 删除建议提示词,无请求体。
示例:设置智能体系统提示词时只发送变化的键,使用 curl -X PUT 请求 settings/ 端点并携带 Authorization 与 Content-Type 头,请求体为 {"system_prompt": "You are a friendly study coach. Keep answers concise."}。
限制与注意:内置提示词与问候开关通过 settings/ 保存,只发送变化的键,不要发送整个对象。建议提示词是 ai-prompt/…/prompt/ 下的独立资源,用 POST 创建、按 {id} 用 PUT 编辑、按 {id} 用 DELETE 删除。建议提示词列表端点分页,使用 limit 和 offset 翻页。其他细节暂未提供。