iblai-search

用途：在 ibl.ai 组织内发现智能体（agent/mentor）与学习内容，并提供个性化推荐。

主要能力：

1. 智能体搜索：GET https://api.iblai.app/dm/api/search/orgs/{org}/users/{username}/mentors/，支持 query、category、created_by、limit、page，返回 results[]、count、next、previous、current_page、total_pages、facets。
2. 内容搜索：GET https://api.iblai.app/dm/api/search/catalog/，支持 query、limit、page 及内容类型（course/program/pathway/skill）、语言、级别、主题、格式、价格、证书等筛选；结果为 {type, data}。
3. 推荐：GET https://api.iblai.app/dm/api/ai-search/recommendations/，无 query，服务端按令牌对应用户生成 RAG 排序结果，参数 recommendation_type（mentors|courses|programs|resources|pathways）与 limit。
4. 新版 /api/ai-search/ 系列：全局导师搜索（/mentors/，可匿名，可传 platform_key）、个性化导师（/personalized-mentors/，需认证）、可售项搜索（/sellable-items/，需 CanSellItems 权限），以及管理员推荐提示词接口。

使用方式：基础地址为 https://api.iblai.app/dm，请求头 Authorization: Api-Token $IBLAI_API_KEY。{org}=$IBLAI_ORG，{username}=$IBLAI_USERNAME（仅组织级智能体搜索需）；/api/ai-search/ 与内容搜索不带组织路径，org/user 来自令牌或查询参数。未连接时先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。示例：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/catalog/?query=manufacturing&limit=10" -H "Authorization: Api-Token $IBLAI_API_KEY"。

适用场景：浏览与检索组织内智能体、检索课程等学习内容、获取个性化推荐、按平台范围搜索导师、为定价配置检索可售项、由管理员维护推荐提示词。

限制：发现类接口（智能体/内容/推荐/导师/可售项搜索）均为只读；只有管理员推荐提示词接口（POST/PUT/DELETE …/ai-search/prompts/）会写入。提示词管理仅限平台管理员，可售项接口需 CanSellItems 权限。搜索需显式查询与筛选、结果对任意调用者一致；推荐无查询、因人而异、依赖令牌。facets 枚举可用筛选维度与计数，可用于构造后续筛选参数。智能体结果的 unique_id 即传给 /iblai-agent-* 技能的 {mentor}；内容结果 data 结构随类型而异。其他细节资料未提供。