SuperAPI AI 工具集

iblai-agent-settings

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 ibl.ai 平台 API 读取和写入智能体的核心设置,包括身份信息(名称、描述、分类、头像)、发现与可见性,以及能力开关(匿名、精选、LTI、附件、语音、记忆、多查询 RAG、可复制),并支持复制(fork)和删除智能体。适用于配置智能体的基本身份与能力。

认证与约定:基础地址为 https://api.iblai.app;每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org} 为 $IBLAI_ORG,{username} 为 $IBLAI_USERNAME,{mentor} 为智能体唯一 id。设置写入统一走 PUT …/users/{username}/mentors/{mentor}/settings/,使用 multipart/form-data,只发送发生变化的字段。若尚未连接,先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。

读取:GET …/mentor/categories/ 获取分类选项;GET …/mentors/{mentor}/settings/ 加载当前全部字段值;GET …/mentors/{mentor}/claw-config/ 检测沙箱接线(404 表示未连接)。

写入:PUT settings/ 可更新 mentor_name、mentor_description、categories、uploaded_profile_image、mentor_visibility、allow_anonymous、is_featured、is_lti_accessible、show_attachment、show_voice_call、show_voice_record、enable_claw、enable_memory_component、enable_multi_query_rag、forkable。POST …/mentors/{mentor}/fork/ 复制智能体,需 new_mentor_name 与 destination_platform_key,可选 clone_documents。DELETE …/users/{username}/{mentor}/ 删除智能体,无请求体,属破坏性操作,需先与用户确认。

示例:重命名并设为精选,只发送两个变化字段: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 "mentor_name=Joseph (Prod)" -F "is_featured=true"。

限制与注意:PUT 中未包含的字段保持不变,不要重发整个对象;categories 需使用分类接口返回的数字 id 而非名称;删除与复制以 {username} 为范围,设置读写使用 users/{username}/mentors/{mentor}/ 路径。