用途:通过 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-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}/ 更新;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/ 保存,只发送变化的键,不要发送整个对象;建议提示词列表端点分页,需用 limit 与 offset 翻页。其余如具体权限范围、速率限制、错误码等资料暂未提供。