TeamDay.ai
← Docs

分析报告器 - 完整示例

构建一个 AI 代理，连接到 Google Analytics、分析您的网站流量、生成见解并向您的团队发送自动化每日报告。

您将构建什么

分析报告代理，可以：

  • 连接到 Google Analytics 4 (GA4)
  • 查询流量指标和用户行为
  • 识别趋势和异常
  • 生成每日/每周报告
  • 创建可操作的建议
  • 通过 Slack 或电子邮件发送报告

完成时间： 45-60 分钟

先决条件

开始前，您需要：

  • 拥有组织的 TeamDay 账户
  • 拥有数据的 Google Analytics 4 属性
  • Google Cloud 项目（用于 OAuth）
  • Anthropic API 密钥
  • （可选）Slack 工作区用于通知

架构概述

graph LR
    A[Scheduled Mission] --> B[Analytics Agent]
    B --> C[Google Analytics MCP]
    C --> D[GA4 API]
    B --> E[Data Analysis]
    E --> F[Report Generation]
    F --> G[Slack/Email]
    B --> H[Insights Agent]
    H --> I[Recommendations]

第 1 步：Google Cloud 设置

1.1 创建 Google Cloud 项目

  1. 转至 Google Cloud 控制台
  2. 创建新项目：“TeamDay Analytics”
  3. 记下您的项目 ID：teamday-analytics-12345

1.2 启用 Google Analytics API

# 使用 gcloud CLI
gcloud services enable analyticsdata.googleapis.com
gcloud services enable analytics.googleapis.com

# 或通过 Cloud 控制台：
# APIs & Services → Enable APIs → 搜索"Google Analytics Data API"

1.3 创建 OAuth 2.0 凭据

创建 OAuth 客户端：

  1. APIs & Services → 凭据
  2. 创建凭据 → OAuth 客户端 ID
  3. 应用程序类型：Web 应用程序
  4. 名称：“TeamDay Analytics Reporter”
  5. 授权重定向 URI：
    • https://app.teamday.app/auth/google/callback
    • http://localhost:3000/auth/google/callback（用于测试）
  6. 点击创建
  7. 下载 JSON 凭据

保存这些值：

{
  "client_id": "...",
  "client_secret": "..."
}