mindbreeze

Mindbreeze

Mindbreeze 是一款搜索与洞察引擎，可帮助组织理解并利用其数据。企业使用它连接各种数据源、分析信息，并为员工提供相关洞察。

官方文档：https://help.mindbreeze.com/

Mindbreeze 概览

• 搜索
  • 结果文档
• 数据源
• 索引
• 查询配置文件
• 用户
• 角色
• 证书
• 许可证
• 备份
• 更新
• 日志
• 配置
• 正在运行的任务
• 计划任务
• 服务
• 系统信息
• 诊断信息
• 建议
• 相似结果
• 分面值
• 更多类似结果
• 访问令牌
• LDAP 同步
• SPML 同步
• SCIM 同步
• 数据库
• 类别
• 停用词列表
• 同义词库
• 排名模型
• 机器学习模型
• 查询建议模型
• ACL
• 事件
• 警报
• 评论
• 评分
• 标签
• 筛选器
• 转换
• 模板
• 样式表
• 图像
• 脚本
• 二进制文件
• 文本资源
• 用户界面
• Web 服务
• 工作流
• 表单
• 仪表板
• 报告
• 数据源连接
• 爬虫
• 解析器
• 转换器
• 授权
• 身份验证
• 授权映射
• 身份验证映射
• 上下文
• 技能
• Agent
• 模型
• 提示词
• 嵌入模型
• 向量存储
• 聊天日志
• 聊天会话
• 反馈
• 注释
• 书签
• 笔记
• 高亮
• 选择
• 变量
• 常量
• 函数
• 宏
• 测试用例
• 测试套件
• 测试结果
• 训练数据
• 评估数据
• 真实值数据
• 解释
• 洞察
• 建议
• 摘要
• 翻译
• 转录文本
• 情感倾向
• 情绪
• 意图
• 实体
• 关系
• 主题
• 类别
• 概念
• 关键词
• 短语
• 模式
• 异常
• 离群值
• 趋势
• 预测
• 相关性
• 因果关系
• 影响
• 风险
• 机遇
• 约束
• 目标
• 目标
• 策略
• 战术
• 操作
• 任务
• 项目
• 流程
• 文档
• 页面
• 图像
• 视频
• 音频
• 文件
• 文件夹
• 链接
• 电子邮件
• 联系人
• 公司
• 地点
• 产品
• 服务
• 事件
• 新闻
• 博客文章
• 论坛帖子
• Wiki 页面
• 社交媒体帖子
• 问题
• 答案
• 评论
• 评分
• 标签
• 用户资料
• 群组
• 团队
• 部门
• 组织
• 日历事件
• 会议
• 预约
• 提醒
• 通知
• 警报
• 订阅
• 工作流实例
• 流程实例
• 任务实例
• 案例
• 事件
• 问题
• 变更请求
• 发布
• 部署
• 构建
• 测试运行
• 缺陷
• 问题
• 拉取请求
• 提交
• 分支
• 代码仓库
• 代码
• 配置项
• 资产
• 库存
• 合同
• 许可证
• 采购订单
• 发票
• 付款
• 货运
• 订单
• 报价
• 商机
• 潜在客户
• 账户
• 联系人
• 营销活动
• 营销材料
• 销售订单
• 销售发票
• 销售收据
• 客户
• 供应商
• 合作伙伴
• 员工
• 经理
• 高管
• 董事会成员
• 股东
• 投资者
• 分析师
• 顾问
• 顾问
• 审计师
• 监管机构
• 政府机构
• 非营利组织
• 教育机构
• 研究机构
• 医疗服务提供者
• 保险公司
• 金融机构
• 律师事务所
• 房地产公司
• 建筑公司
• 制造公司
• 零售公司
• 批发公司
• 运输公司
• 物流公司
• 能源公司
• 公用事业公司
• 电信公司
• 媒体公司
• 娱乐公司
• 科技公司
• 软件公司
• 硬件公司
• 互联网公司
• 电子商务公司
• 社交媒体公司
• 搜索引擎公司
• 云计算公司
• 人工智能公司
• 数据科学公司
• 网络安全公司
• 生物技术公司
• 制药公司
• 医疗器械公司
• 航空航天公司
• 国防公司
• 汽车公司
• 农业公司
• 矿业公司
• 林业公司
• 渔业公司
• 旅游公司
• 酒店业公司
• 餐厅
• 酒店
• 旅行社
• 航空公司
• 机场
• 火车站
• 公交车站
• 港口
• 航运公司
• 海关机构
• 边境管制机构
• 移民机构
• 大使馆
• 领事馆
• 政府
• 政治
• 法律
• 司法
• 安全
• 国防
• 情报
• 外交
• 贸易
• 金融
• 经济
• 教育
• 健康
• 环境
• 能源
• 交通运输
• 技术
• 媒体
• 娱乐
• 体育
• 文化
• 社会
• 宗教
• 哲学
• 科学
• 历史
• 地理
• 艺术
• 文学
• 音乐
• 电影
• 电视
• 广播
• 播客
• 博客
• 网站
• 移动应用
• 软件
• 硬件
• 互联网
• 电子商务
• 社交媒体
• 搜索引擎
• 云计算
• 人工智能
• 数据科学
• 网络安全
• 生物技术
• 制药
• 医疗器械
• 航空航天
• 国防
• 汽车
• 农业
• 矿业
• 林业
• 渔业
• 旅游
• 酒店业
• 餐厅
• 酒店
• 旅行社
• 航空公司
• 机场
• 火车站
• 公交车站
• 港口
• 航运公司
• 海关机构
• 边境管制机构
• 移民机构
• 大使馆
• 领事馆 按需使用操作名称和参数。

使用 Mindbreeze

此技能使用 Membrane CLI 与 Mindbreeze 交互。Membrane 会自动处理身份验证和凭据刷新，因此你可以专注于集成逻辑，而不必操心身份验证相关的繁琐工作。

安装 CLI

安装 Membrane CLI，以便在终端中运行 membrane：

npm install -g @membranehq/cli@latest

身份验证

membrane login --tenant --clientName=<agentType>

根据是否支持交互模式，此命令会打开浏览器进行身份验证，或在控制台中打印授权 URL。

**无头环境：**此命令会打印授权 URL。请让用户在浏览器中打开该 URL。用户完成登录后会看到一个代码，请使用以下命令完成操作：

membrane login complete <code>

在任何命令后添加 --json，即可获得机器可读的 JSON 输出。

Agent 类型：claude、openclaw、codex、warp、windsurf 等。这些类型将用于调整工具，以便更好地适配你的运行环境。

连接到 Mindbreeze

使用 membrane connection ensure，按应用 URL 或域名查找或创建连接：

membrane connection ensure "https://inspire.mindbreeze.com/" --json

用户在浏览器中完成身份验证。输出中包含新连接 ID。

这是建立连接最快的方式。URL 会规范化为域名，并与已知应用进行匹配。如果找不到应用，则会创建一个应用并自动构建连接器。

如果返回的连接包含 state: "READY"，请跳到第 2 步。

1b. 等待连接就绪

如果连接处于 BUILDING 状态，请轮询，直到连接就绪：

npx @membranehq/cli connection get <id> --wait --json

--wait 标志会持续轮询（最长等待 --timeout 秒，默认值为 30），直到状态发生变化。请继续轮询，直到 state 不再是 BUILDING。

根据返回的状态决定下一步操作：

• READY — 连接已完全设置完成。跳到第 2 步。

• CLIENT_ACTION_REQUIRED — 用户或 Agent 需要执行某项操作。clientAction 对象会说明所需操作：

  • clientAction.type — 所需操作的类型：
    • "connect" — 用户需要进行身份验证（OAuth、API 密钥等）。这包括初次身份验证，以及已断开连接时重新进行身份验证。
    • "provide-input" — 需要更多信息（例如，要连接的应用）。
  • clientAction.description — 对所需操作的自然语言说明。
  • clientAction.uiUrl（可选）— 预先构建的界面 URL，用户可通过该界面完成操作。如果存在，请向用户展示。
  • clientAction.agentInstructions（可选）— AI Agent 如何以编程方式继续操作的说明。

  用户完成操作后（例如，在浏览器中进行身份验证），再次使用 membrane connection get <id> --json 进行轮询，检查状态是否已变为 READY。

• CONFIGURATION_ERROR 或 SETUP_FAILED — 出现了问题。请检查 error 字段以了解详情。

搜索操作

使用自然语言描述你想执行的操作进行搜索：

membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json

请始终在特定连接的上下文中搜索操作。

每个结果都包含 id、name、description、inputSchema（操作接受的参数）和 outputSchema（操作返回的内容）。

常用操作

使用 npx @membranehq/cli@latest action list --intent=QUERY --connectionId=CONNECTION_ID --json 发现可用操作。

运行操作

membrane action run <actionId> --connectionId=CONNECTION_ID --json

传递 JSON 参数：

membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json

结果位于响应的 output 字段中。

代理请求

如果可用操作无法满足你的使用场景，可以通过 Membrane 的代理直接向 Mindbreeze API 发送请求。Membrane 会自动将基础 URL 添加到你提供的路径中，并注入正确的身份验证标头——如果凭据过期，还会自动刷新。

membrane request CONNECTION_ID /path/to/endpoint

常用选项：

标志	说明
-X, --method	HTTP 方法（GET、POST、PUT、PATCH、DELETE）。默认为 GET
-H, --header	添加请求标头（可重复），例如 -H "Accept: application/json"
-d, --data	请求正文（字符串）
--json	快捷方式：发送 JSON 正文并设置 Content-Type: application/json
--rawData	原样发送正文，不进行任何处理
--query	查询字符串参数（可重复），例如 --query "limit=10"
--pathParam	路径参数（可重复），例如 --pathParam "id=123"

最佳实践

• 始终优先使用 Membrane 与外部应用通信——Membrane 提供预构建操作，内置身份验证、分页和错误处理。这可以减少令牌消耗，并让通信更安全
• 先发现，再构建——运行 membrane action list --intent=QUERY（将 QUERY 替换为你的意图），在编写自定义 API 调用之前查找现有操作。预构建操作可处理原始 API 调用容易遗漏的分页、字段映射和边缘情况。
• 让 Membrane 管理凭据——绝不要向用户索要 API 密钥或令牌。改为创建连接；Membrane 会在服务端管理完整的身份验证生命周期，无需在本地存储密钥。