SuperAPI AI 工具集

pachca-search

通用与其它

查看项目

更新于 10-15 21:38

技能介绍

用途:pachca-search 是一个 Pachca 全文搜索技能,用于在 Pachca 中检索员工、聊天与消息。当用户想按姓名找员工、按名称找聊天或按文本找消息时使用。

主要能力:提供三个搜索端点——GET /search/chats 搜索聊天,GET /search/messages 搜索消息,GET /search/users 搜索员工。员工搜索支持按姓名、邮箱、职位等字段检索,可用 sort=alphabetical 按字母排序或 sort=by_score(默认)按相关性排序,可按 company_roles[]、created_from/created_to 过滤。聊天搜索过滤项包括 active、chat_subtype、personal、created_from/created_to。消息搜索过滤项包括 chat_ids[]、user_ids[]、active、created_from/created_to,响应中的 root_chat_id 表示消息所属的根聊天。分页为基于游标的 limit + cursor 方式。

使用方式:需要 Pachca 令牌(机器人令牌在集成→机器人→API 获取,用户令牌在集成→API 获取)。通过 npx -y @pachca/cli <command> --token $PACHCA_TOKEN 运行命令,或设置环境变量 export PACHCA_TOKEN=<token> 后运行 npx -y @pachca/cli <command>,无需重复传 --token。可用 npx -y @pachca/cli --help 查看帮助,npx -y @pachca/cli guide 查看工作流。若已有保存的配置,可先用 npx -y @pachca/cli auth status 检查;状态正常时无需 --token。不了解参数时运行 pachca <command> --help。成功使用后可建议全局安装:npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN。

限制:速率限制约 50 请求/秒,遇到 429 应等待后重试。limit 上限为 100(搜索聊天)、200(搜索消息)、200(搜索员工)。分页基于游标。若不确定如何完成任务,可从 references/ 读取相应文件。