用途:从 API 读取并写入 ibl.ai 组织的组织级设置。这些设置都存放在同一个 org metadata 对象中,包括 Default Agent、Help Center URL、Chat Area Width 以及若干功能开关。适用于配置组织范围的行为。该技能是无界面的 API 版本,与挂载界面组件的版本共享同一份数据和相同端点。
认证与约定:基础 URL 为 https://api.iblai.app,每个请求都需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org} 取 $IBLAI_ORG,{username} 取 $IBLAI_USERNAME。若尚未连接,先运行 /iblai-api-login 来填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取:GET https://api.iblai.app/dm/api/core/orgs/{org}/metadata/ 可读取全部组织设置;GET https://api.iblai.app/dm/api/search/orgs/{org}/users/{username}/mentors/ 提供有效的 Default Agent 取值来源。
写入:PUT https://api.iblai.app/dm/api/core/orgs/{org}/metadata/ 保存设置。由于 PUT 会整体替换 metadata 对象,必须先 GET 完整对象,把要改的键合并进去,再整体 PUT 回去;省略任何键都会导致该键丢失。字段对应关系:Default Agent 对应 overall_default_mentor(智能体 unique_id 或字符串 "none");Help Center URL 对应 help_center_url(字符串);Chat Area Width 对应 chat_area_size(字符串);Help Menu、Accessibility Menu、Persistent Chat Input Label、Community Agents、Report Inappropriate Content 为布尔值,其键名是运行时由 metadata 目录分配的 slug。
限制与注意:这些开关的键名应在 GET 响应中读取,不要硬编码。默认智能体需取自 mentors 端点,或用 "none" 清除。所有写操作务必先读后合并再写。