用途:通过 ibl.ai 平台 API 设置某个智能体的 LLM 提供商与模型。适用于需要更换智能体所运行模型的场景。
主要能力:读取当前 provider/model;列出可用的 provider/model 卡片;通过 settings/ 端点写入所选 provider 与 model。
认证与约定:基础 URL 为 https://api.iblai.app;每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量:{org} = $IBLAI_ORG,{username} = $IBLAI_USERNAME,{mentor} = 智能体唯一 id(例如 d17dc729-60fd-4363-81a0-f67d9318b03e)。provider/model 选择通过同一 settings/ 端点保存:PUT …/users/{username}/mentors/{mentor}/settings/。若尚未连接,先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取接口:GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentors/{mentor}/settings/ 获取当前 provider/model;GET https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}/mentor-llms/?mentor_id={mentor} 获取 provider/model 卡片。
写入接口:PUT …/users/{username}/mentors/{mentor}/settings/,请求体需包含 llm_provider(字符串,必填)与 llm_name(字符串,必填)。
示例:将智能体切换为 OpenAI 的 GPT-4o:
curl -X PUT
"https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/mentors/$MENTOR/settings/"
-H "Authorization: Api-Token $IBLAI_API_KEY"
-F "llm_provider=openai"
-F "llm_name=gpt-4o"
限制与注意:应先拉取 provider/model 卡片,再发送恰好一组出现在该列表中的 llm_provider + llm_name,取值必须匹配真实卡片。选择通过共享的 settings/ 端点持久化,因此会与同一智能体的其他配置字段并存。