Nox-Lumen MfgNox-Lumen Mfg

邮件集成（SMTP / IMAP）

数据流

Rendering diagram…

能力总览

方向协议能力
发信SMTP / SMTPS文本 / HTML / 附件 / 内联图片 / 模板
收信IMAP / IMAPS拉取邮件 / 按文件夹 / 按条件搜索 / 下载附件
监听IMAP IDLE / 轮询新邮件事件触发 Agent
规则本地规则引擎按发件人 / 主题 / 附件类型路由

前置条件

邮箱类型推荐凭据常见配置
企业自建 Exchange / Postfix用户名 + 密码IMAP: 993 SSL, SMTP: 465/587
Gmail应用专用密码 or OAuth 2.0imap.gmail.com:993 / smtp.gmail.com:465
Microsoft 365 / OutlookOAuth 2.0（推荐）outlook.office365.com:993
腾讯企业邮 / 网易企业邮授权码参考各家官方文档

Gmail / Outlook 已逐步关闭"用户名+密码"登录 IMAP。生产用 OAuth 2.0。

配置步骤

步骤 1：创建凭据

管理台 → 集成 → 邮件 → 新增：

  • Name：alice@corp.com
  • IMAP Host / Port / SSL
  • SMTP Host / Port / SSL
  • Username / Password（或 OAuth）
  • From Address：发件默认地址

步骤 2：验证收发

combo-cli integration test --credential <cred_id> --type mail
# ✓ IMAP login OK
# ✓ SMTP send OK (to self)

步骤 3：配置触发规则（可选）

管理台 → 事件触发 → 新增：

trigger:
  source: email
  credential_id: <cred_id>
  match:
    folder: INBOX
    from_regex: "@supplier\\.com$"
    subject_regex: "报价|quote"
  action:
    agent_id: "quote-assistant"
    session_template: "per-sender"   # 同发件人归同一 Session
    inputs:
      subject: "{{ email.subject }}"
      body: "{{ email.body_text }}"
      attachments: "{{ email.attachments }}"

步骤 4：自动回复（可选）

在 Agent 完成后自动回信：

on_finish:
  reply_email:
    credential_id: <cred_id>
    to: "{{ trigger.email.from }}"
    subject: "Re: {{ trigger.email.subject }}"
    body_html: "{{ agent.output_html }}"

典型场景

场景配置要点
客户询价 → 自动分析 + 草稿回复IMAP 监听 + Agent 起草 + 人工确认再发
测试报告 / 审查报告邮件分发Agent 完成后出站 SMTP 发送
会议纪要自动邮件周报Cron 触发 + 多收件人分发
供应商确认单自动入库IMAP 监听 + 附件解析 + 入 KB

大附件 / 安全

  • 附件大小：SMTP 默认 25 MB，超出走云存储链接（MinIO 临时签名 URL）
  • DKIM / SPF / DMARC：发件用自有域名要配置 DNS 记录
  • TLS 强制：可以在凭据里勾选 require_tls: true
  • 敏感词过滤：在 Hook 里过滤外发邮件

常见坑位

问题解决
IMAP IDLE 半小时就断配置 keepalive，SDK 默认 25min 重连一次
发出的邮件进对方垃圾箱配 SPF / DKIM / DMARC，降频，避免大量群发
中文主题乱码确保使用 UTF-8 + 正确的 MIME 编码
OAuth Token 过期refresh token 流程；Outlook 刷新间隔较短

相关文档

Next

产品介绍

On this page

数据流能力总览前置条件配置步骤步骤 1：创建凭据步骤 2：验证收发步骤 3：配置触发规则（可选）步骤 4：自动回复（可选）典型场景大附件 / 安全常见坑位相关文档