Audryo

Audryo Agent 工具包

让你的 AI Agent 通过 Audryo 中与应用相同的 API，管理生命周期邮件：受众、旅程、营销活动、邮件和事务性发送。你的 Agent 负责设置；只有经过人工批准后，内容才会发送给客户。

此仓库提供 audryo CLI、一个 MCP 服务，以及适用于 Claude Code、Codex、Cursor 和其他 MCP 客户端的 Agent 技能。

You:   Set up an onboarding journey for signups who haven't created a
       project after 3 days.

Agent: Reads your data schema, builds the audience, drafts a three-email
       journey, dry-runs it and fast-forwards it in the sandbox. Then it
       hands back what to review. Nothing has been sent.

安全模型

• 默认创建草稿。 Agent 创建的旅程、邮件和营销活动都是仅供审核的提案。
• 发送需要 deliver。 没有此权限范围，密钥就无法激活旅程或发送任何内容，即使是误操作也不行。即使有此权限，Audryo 仍要求通过试运行并确认邮件。
• 先使用沙盒。 新项目会将每封邮件都发送到沙盒收件箱，这样 Agent 就能端到端测试真实旅程。是否正式上线由用户在应用中决定。
• 重试安全。 发送和提案都需要 Idempotency-Key，因此重试调用不会重复发送。
• 不推断用户同意。 导入联系人不会自动授予营销许可。

快速开始

1. 注册（公开测试版期间免费）并创建项目。项目初始状态为沙盒模式。
2. 在 Settings → Developer 下创建 API 密钥，并选择满足需求的最小权限范围（参见配置）。
3. 连接你的 Agent：

Claude Code（插件：MCP 服务 + 技能）

export AUDRYO_API_KEY="sf_live_..."
claude plugin marketplace add Audryo/agent-toolkit
claude plugin install audryo@audryo

任意 Agent：仅使用技能

npx skills add Audryo/agent-toolkit

任意 MCP 客户端

{
  "mcpServers": {
    "audryo": {
      "command": "npx",
      "args": ["-y", "audryo", "mcp"],
      "env": {
        "AUDRYO_API_KEY": "sf_live_...",
        "AUDRYO_PROJECT_ID": "<project-uuid>"
      }
    }
  }
}

Codex：codex mcp add audryo --env AUDRYO_API_KEY=sf_live_... -- npx -y audryo mcp

配置

变量	必需	默认值
AUDRYO_API_KEY	是	—
AUDRYO_PROJECT_ID	使用项目工具时需要	使用 npx audryo bootstrap 列出
AUDRYO_API_BASE	否	https://api.audryo.com/v1

为 Agent 提供满足需求的最小权限密钥：

任务	权限范围
检查	read
同步数据、起草旅程、邮件和营销活动	read、write
激活旅程、发送营销活动和事务性邮件	read、write、deliver

MCP 工具

类别	工具	权限范围
概览	get_manifest、get_bootstrap、get_setup_context、get_brief、get_plan_usage	read
产品与数据	get_product_context、get_data_context、list_contacts、ingest_contacts、ingest_events	read / write
受众	list_audiences、get_audience、preview_audience、create_audience、update_audience、delete_audience、suggest_audiences	read / write
旅程	list_journeys、inspect_journey、create_journey_proposal、revise_journey、propose_from_finding、run_dry_run	read / write
邮件	create_email、create_journey_email	write
营销活动	list_campaigns、draft_campaign	read / write
沙盒	get_delivery_mode、list_sandbox_messages、get_sandbox_message、fast_forward_journey	read / write
洞察	get_delivery_health、get_performance、get_observation、run_observation、get_copilot_plan	read
正式上线	activate_journey、pause_journey、send_campaign、send_transactional	deliver

每个工具也都对应一个 CLI 命令。

CLI

npx audryo bootstrap
npx audryo contacts ingest contacts.json
npx audryo events ingest events.json
npx audryo journeys list
npx audryo journeys inspect <workflowId>
npx audryo audiences create --name "All contacts" --definition '{"operator":"and","conditions":[]}'
npx audryo campaigns draft --name "July update" --audience-id <id> --subject "What's new"
npx audryo delivery health

技能

技能	教会 Agent 如何
audryo-api	连接、选择权限范围、使用 MCP 或 CLI 而非 curl，并在审核环节停止
audryo-email	构建有效的邮件文档、处理地区设置，并保存草稿以供审核
audryo-sending	选择通信类别、遵守许可要求并保障送达率

完整指南：https://app.audryo.com/docs/agents/quickstart

贡献

欢迎提交问题和拉取请求。请参阅 CONTRIBUTING.md 和 changelog。请通过以下方式私下报告安全问题： SECURITY.md。

许可证：MIT