SuperAPI AI 工具集

iblai-api-search

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 ibl.ai 平台 API 发现组织内的智能体(agents)与学习内容(课程、项目、路径、技能),并提供个性化推荐。

主要能力:

  1. 智能体搜索:GET https://api.iblai.app/dm/api/search/orgs/{org}/users/{username}/mentors/,支持 query 全文检索、category、created_by、limit、page 等参数,返回 results、count、facets 等。
  2. 内容搜索:GET https://api.iblai.app/dm/api/search/catalog/,支持 query 与内容类型、语言、级别、主题、格式、价格、证书等筛选,结果为 {type, data} 结构。
  3. 推荐:GET https://api.iblai.app/dm/api/ai-search/recommendations/,无 query,按 recommendation_type(mentors/courses/programs/resources/pathways)返回个性化 RAG 排序结果。
  4. 较新的 /api/ai-search/ 系列:全局智能体搜索 mentors/、个性化 personalized-mentors/、可售项 sellable-items/(需 CanSellItems 权限),以及管理员推荐提示词管理。

使用方式:基础地址为 https://api.iblai.app/dm,路径需带 /dm 前缀;每个请求带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME(仅智能体搜索)。未连接时先运行 /iblai-api-login 填充环境变量。示例: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"。

适用场景:在 ibl.ai 组织内检索智能体与课程目录、为登录用户生成个性化推荐、为卖家查找可售项、由平台管理员维护推荐提示词。

限制:发现类接口均为只读,仅管理员推荐提示词端点(POST/PUT/DELETE …/ai-search/prompts/)会写入,且需先与用户确认;sellable-items 需 CanSellItems 权限;推荐结果依赖令牌对应用户,无显式查询参数。编辑智能体请使用 /iblai-api-agent-* 技能。其余细节暂未提供。