用途:设置某个 ibl.ai 智能体的 LLM 提供商(llm_provider)与模型(llm_name)。更换智能体所用模型时使用。
主要能力:读取当前提供商/模型;列出可选的提供商/模型卡片;通过写入设置接口保存选择。选择保存在共享的 settings/ 端点,与其他智能体配置字段并存,因此持久生效。
使用方式:基础地址 https://api.iblai.app,每次请求都带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量:{org} 取 $IBLAI_ORG,{username} 取 $IBLAI_USERNAME,{mentor} 为智能体唯一 id(例如 d17dc729-60fd-4363-81a0-f67d9318b03e)。未连接时先运行 /iblai-api-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}/mentors/{mentor}/mentor-llms/?mentor_id={mentor}。
写入设置: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"
限制:应先拉取提供商/模型卡片,再发送列表中确实存在的单个 llm_provider + llm_name 组合,取值必须匹配真实卡片。其余计费、平台或效果信息暂未提供。