SuperAPI AI 工具集

iblai-api-search

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 ibl.ai 平台 API 发现智能体与学习内容,包括智能体搜索、目录内容搜索和个性化推荐三类只读发现能力,以及较新的 /api/ai-search/... 系列(全局与个性化智能体搜索、可售项搜索、推荐提示词管理)。

基础约定:基础地址为 https://api.iblai.app/dm(属于 Data Manager 端点,/dm 前缀必需)。每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org} = $IBLAI_ORG,{username} = $IBLAI_USERNAME(仅智能体搜索使用;v2 的 /api/ai-search/... 与内容搜索不带 org 路径,org/user 来自令牌或查询参数)。未连接时先运行 /iblai-api-login 填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。

主要能力: 1)智能体搜索:GET /api/search/orgs/{org}/users/{username}/mentors/,参数含 query、category、created_by、limit、page,返回 results、count、next、previous、current_page、total_pages、facets。 2)内容搜索:GET /api/search/global/(/api/search/catalog/ 为旧写法),参数含 query、limit、page 及镜像 facets 的过滤项(内容类型 course/program/pathway/skill、语言、级别、主题、格式、价格、证书等),结果为带 type 与 data 的对象。 3)推荐:GET /api/ai-search/recommendations/,无查询词,结果按用户个性化生成,参数为 recommendation_type(mentors、courses、programs、resources、pathways)与 limit;每种类型单独请求。 4)新接口族:GET /api/ai-search/mentors/(全局智能体搜索,可匿名,传 platform_key 用于 RBAC)、GET /api/ai-search/personalized-mentors/(需登录)、GET /api/ai-search/sellable-items/(需 CanSellItems 权限)。 5)推荐提示词(平台管理员):GET 列表(…/recommendation/prompts/ 为 …/prompts/ 的别名),以及 POST/PUT/DELETE /api/ai-search/prompts/ 进行创建、更新、删除,写操作前需向用户确认。

使用方式示例: curl -s "https://api.iblai.app/dm/api/search/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/mentors/?query=calculus&limit=10" -H "Authorization: Api-Token $IBLAI_API_KEY" curl -s "https://api.iblai.app/dm/api/search/global/?query=manufacturing&limit=10" -H "Authorization: Api-Token $IBLAI_API_KEY"

适用场景:在 ibl.ai 组织中查找智能体、浏览课程等学习目录、获取个性化推荐、为卖家进行可售项检索与定价准备、管理员维护推荐提示词。

限制:发现类接口(智能体/内容/推荐/全局智能体/可售项搜索)均为只读,唯一写操作是管理员推荐提示词端点;搜索结果中的 unique_id 可作为 /iblai-api-agent-* 技能所需的 {mentor};搜索需显式查询词与过滤,推荐无查询词且因令牌而异;价格与格式过滤的记录范围比对应 facet 计数更窄;平台管理员、CanSellItems 等权限与鉴权细节需以实际令牌为准,其他计费、价格与平台信息暂未提供。