Agent 管理

AI 代理是 Solokit 的智能核心，能够自动执行网站分析、生成优化建议，并持续监控网站表现。

什么是 AI 代理

AI 代理是一个智能化的分析助手，它可以：

• 🤖 自动分析 - 定期执行网站分析任务
• 🧠 智能诊断 - 识别 SEO/GEO 问题和机会
• 📝 生成建议 - 提供可执行的优化建议
• 📊 趋势监控 - 跟踪指标变化和趋势
• 🔄 持续优化 - 循环改进优化策略

代理类型

SEO 分析代理

专注于传统搜索引擎优化：

主要功能

• 技术 SEO 审计
• 页面优化检测
• 链接结构分析
• 内容质量评估
• 竞对对比分析

适用场景

• 提升 Google 搜索排名
• 优化百度搜索表现
• 改善网站技术结构
• 增强页面 SEO 得分

GEO 优化代理

针对 AI 搜索引擎优化：

主要功能

• AI 内容理解评估
• 语义相关性分析
• 结构化数据优化
• 问答内容优化
• AI 可见度提升

适用场景

• 提升页面被模型抽取的就绪度（输入侧）
• 优化 Perplexity / AI 搜索的可读结构
• 改善内容被 AI 理解
• 真实「会不会被提到 / 推荐 / 引用」请用 回答探针，不要把页面 GEO 分当成 ChatGPT 引用率

性能监控代理

持续监控网站性能：

主要功能

• Core Web Vitals 监测
• 页面加载速度分析
• 资源优化建议
• 性能趋势跟踪
• 问题实时预警

适用场景

• 保持高性能得分
• 快速发现性能问题
• 持续性能优化
• 用户体验提升

内容优化代理

专注于内容质量：

主要功能

• 内容质量评估
• 关键词优化建议
• 可读性分析
• 内容更新提醒
• 原创性检测

适用场景

• 提升内容质量
• 优化关键词策略
• 改善用户阅读体验
• 保持内容新鲜度

竞对分析代理

监控竞争对手：

主要功能

• 竞对网站监控
• 关键词对比分析
• 内容策略分析
• 排名变化追踪
• 差距识别

适用场景

• 了解竞争态势
• 发现优化机会
• 制定竞争策略
• 保持竞争优势

创建代理

快速创建

1. 进入 "AI 代理" 页面
2. 点击 "创建代理" 按钮
3. 选择代理类型
4. 配置基本设置
5. 保存并启用

详细配置

基本信息

{
  "name": "我的 SEO 代理",
  "type": "seo_analysis",
  "description": "负责主站的 SEO 分析",
  "enabled": true
}

执行设置

执行频率

• 每小时
• 每日（推荐）
• 每周
• 每月
• 自定义 Cron 表达式

执行时间

• 选择具体时间点
• 避开流量高峰
• 考虑时区差异

超时设置

• 单次执行超时时间
• 重试次数
• 失败处理策略

目标网站

选择代理要分析的网站：

• 单个网站
• 网站组
• 所有网站
• 按标签筛选

分析深度

快速模式

• 检查关键页面
• 基础指标评估
• 执行时间：2-5 分钟

标准模式（推荐）

• 全面页面分析
• 详细指标检测
• 执行时间：5-15 分钟

深度模式

• 全站深度扫描
• 完整问题诊断
• 执行时间：15-30 分钟

通知配置

通知触发条件

• 分析完成
• 发现严重问题
• 评分下降
• 竞对超越

通知方式

• 站内通知
• 邮件通知
• 飞书/钉钉
• Webhook

通知内容

• 问题摘要
• 评分变化
• 优化建议
• 详细报告链接

代理管理

代理列表

查看所有配置的代理：

启用/禁用代理

控制代理的运行状态：

启用代理

• 代理将按设定频率自动执行
• 开始接收通知
• 消耗分析额度

禁用代理

• 暂停自动执行
• 停止通知
• 不消耗额度
• 保留配置和历史数据

手动执行

立即执行代理任务：

1. 在代理列表找到目标代理
2. 点击 "立即执行" 按钮
3. 确认执行
4. 查看执行进度
5. 等待完成并查看结果

编辑代理

修改代理配置：

1. 点击代理的 "编辑" 按钮
2. 更新配置项
3. 保存更改
4. 新配置在下次执行时生效

删除代理

移除不需要的代理：

1. 点击 "删除" 按钮
2. 确认删除操作
3. 代理及其执行历史将被删除

⚠️ 注意：删除后无法恢复，请谨慎操作。

代理详情

基本信息

显示代理的配置详情：

• 代理名称和描述
• 创建时间和创建人
• 类型和状态
• 执行频率设置
• 目标网站列表

执行历史

查看代理的执行记录：

列表视图

• 执行时间
• 执行状态（成功/失败/进行中）
• 执行时长
• 发现问题数量
• 操作（查看报告/重新执行）

统计图表

• 执行次数趋势
• 成功率统计
• 平均执行时长
• 问题发现趋势

执行详情

点击某次执行记录查看详情：

执行摘要

• 开始和结束时间
• 执行状态
• 分析的网站和页面数
• 发现的问题数量
• 生成的建议数量

问题列表

• 按严重程度排序
• 问题描述
• 影响页面
• 优化建议

报告链接

• 完整分析报告
• 数据导出选项

性能指标

代理运行的性能统计：

执行效率

• 平均执行时长
• 成功率
• 失败率及原因
• 超时次数

分析覆盖

• 已分析网站数
• 已分析页面数
• 发现问题数
• 已优化问题数

投资回报

• 修复的问题数
• 评分提升
• 排名改善
• 流量增长

高级功能

条件执行

根据条件触发代理执行：

触发条件

• 评分下降超过阈值
• 发现关键问题
• 竞对排名变化
• 流量异常变化

条件表达式

{
  "triggers": [
    {
      "metric": "seo_score",
      "operator": "decrease",
      "threshold": 5,
      "action": "execute"
    }
  ]
}

代理协作

多个代理协同工作：

执行顺序

• 设置代理依赖关系
• 按顺序执行任务
• 共享分析结果

数据共享

• 代理间共享发现
• 避免重复分析
• 提高整体效率

自定义规则

创建自定义分析规则：

规则配置

{
  "rules": [
    {
      "name": "标题长度检查",
      "type": "title_length",
      "severity": "warning",
      "threshold": {
        "min": 30,
        "max": 60
      },
      "message": "标题长度应在 30-60 字符之间"
    }
  ]
}

集成 Webhook

将代理结果推送到外部系统：

Webhook 配置

{
  "webhook": {
    "url": "https://your-system.com/webhook",
    "method": "POST",
    "headers": {
      "Authorization": "Bearer YOUR_TOKEN"
    },
    "events": [
      "execution_complete",
      "issue_found",
      "score_changed"
    ]
  }
}

推送数据格式

{
  "event": "execution_complete",
  "agent": {
    "id": "agent_123",
    "name": "我的 SEO 代理",
    "type": "seo_analysis"
  },
  "execution": {
    "id": "exec_456",
    "status": "success",
    "duration": 180,
    "issues_found": 15
  },
  "results": {
    "score": 85,
    "score_change": -3,
    "critical_issues": 2
  },
  "timestamp": "2025-11-04T10:30:00Z"
}

最佳实践

代理命名

使用清晰的命名规范：

• 包含代理类型：SEO分析-主站
• 包含频率：每日SEO检查
• 包含范围：全站性能监控

执行频率

根据网站类型选择合适的频率：

通知设置

合理配置通知避免干扰：

推荐设置

• ✅ 启用：严重问题通知
• ✅ 启用：评分显著下降
• ✅ 启用：执行失败通知
• ⚠️ 可选：每次执行完成
• ❌ 不推荐：所有问题通知

分析深度

根据需求选择分析深度：

日常监控 → 快速模式

• 检查关键指标
• 快速发现明显问题
• 节省分析额度

定期审计 → 标准模式

• 全面的问题检测
• 平衡效率和深度
• 推荐每周或每月

全面优化 → 深度模式

• 完整的站点诊断
• 发现所有潜在问题
• 适合大型项目启动

监控关键指标

重点关注这些指标：

SEO 代理

• 整体 SEO 评分
• 索引页面数量
• 关键页面排名
• 技术问题数量

GEO 代理

• AI 理解得分
• 结构化数据覆盖
• 问答内容质量
• AI 引用频率

性能代理

• Core Web Vitals
• 页面加载时间
• 资源大小
• 移动端得分

故障排除

代理执行失败

可能原因

1. 目标网站无法访问
2. 超时限制
3. 网络连接问题
4. 权限不足

解决方法

1. 检查网站可访问性
2. 增加超时时间
3. 查看执行日志
4. 重新执行任务

结果异常

如果分析结果异常：

1. 查看执行日志
2. 检查目标网站是否有变化
3. 对比历史数据
4. 手动执行验证
5. 联系技术支持

性能问题

如果代理执行缓慢：

1. 减少分析深度
2. 缩小分析范围
3. 优化执行时间
4. 分批处理大型网站

常见问题

代理额度

Q: 代理执行消耗额度吗？ A: 是的，每次代理执行都会消耗相应的分析额度。

Q: 如何控制额度使用？ A: 调整执行频率、选择合适的分析深度、禁用不必要的代理。

代理数量

Q: 可以创建多少个代理？ A: 根据您的套餐类型，基础版 5 个，专业版 20 个，企业版无限制。

Q: 推荐创建几个代理？ A: 建议针对不同需求创建专门的代理，通常 3-5 个即可覆盖大部分需求。

执行时间

Q: 代理什么时候执行？ A: 根据您设置的执行频率和时间，系统会自动在指定时间执行。

Q: 可以立即执行吗？ A: 可以，点击 "立即执行" 按钮即可手动触发执行。

下一步

• 查看 分析报告 了解代理的分析结果
• 设置 自动化任务 配合代理使用
• 管理 网站 配置分析目标