跳到主要内容

智能体系统

智能体系统是井云平台的核心业务系统,负责管理和处理各种类型的AI智能体,提供完整的智能体生命周期管理功能。

🎯 系统概述

核心功能

  • 智能体管理: 支持多种智能体类型的创建、编辑、删除
  • 分类管理: 智能体的分类和组织,支持精选功能
  • 平台集成: 与多个AI平台的资产同步和管理
  • 媒体资源: 头像、背景图、封面图、演示视频等资源管理
  • 权限控制: 会员专享、源码下载等权限管理
  • 计费模式: 免费、按次付费、订阅等多种计费模式

支持的智能体类型

  • 链接型: 外部链接智能体
  • 工作流集合型: 多个工作流组合
  • 工作流型: 单个工作流智能体
  • 机器人型: AI机器人智能体
  • 提示词型: 基于提示词的智能体

🏗️ 架构设计

系统架构

┌─────────────────────────────────────────┐
│ Agent Service │
│ (端口: 9004) │
├─────────────────────────────────────────┤
│ ┌─────────────┬─────────────┬─────────┐ │
│ │ Service │ Biz │ Data │ │
│ │ Layer │ Layer │ Layer │ │
│ └─────────────┴─────────────┴─────────┘ │
├─────────────────────────────────────────┤
│ ┌─────────────┬─────────────┬─────────┐ │
│ │ PostgreSQL │ Redis │RabbitMQ │ │
│ │ 数据库 │ 缓存 │ 消息队列 │ │
│ └─────────────┴─────────────┴─────────┘ │
└─────────────────────────────────────────┘

技术栈

  • 框架: Go + Kratos v2
  • 数据库: PostgreSQL + Ent ORM
  • 缓存: Redis
  • 消息队列: RabbitMQ
  • 协议: gRPC/HTTP
  • API文档: OpenAPI 3.0

📊 数据模型

核心实体

  • Agent: 智能体主体模型
  • AgentCategory: 智能体分类模型
  • Bot: 机器人模型
  • Workflow: 工作流模型
  • AgentConfig: 各种智能体类型的配置模型

关系设计

Agent (1) ─── (N) AgentCategory
Agent (1) ─── (1) AgentBotConfig
Agent (1) ─── (1) AgentLinkConfig
Agent (1) ─── (1) AgentPromptConfig
Agent (1) ─── (1) AgentWorkflowConfig
Agent (1) ─── (N) AgentWorkflowCollectionConfig

🔧 核心功能

智能体管理

  • 创建智能体: 支持各种类型的智能体创建
  • 编辑智能体: 修改智能体配置和属性
  • 删除智能体: 软删除机制,支持恢复
  • 查询智能体: 多条件查询和分页
  • 智能体分类: 支持分类管理和精选功能

平台资产集成

  • Coze平台: 机器人和工作流同步
  • 豆包平台: AI模型和能力集成
  • 通义千问: 阿里云AI服务
  • 其他平台: 支持更多AI平台扩展

媒体资源管理

  • 头像管理: 智能体头像上传和存储
  • 背景图: 智能体背景图片管理
  • 封面图: 智能体封面图片管理
  • 演示视频: 智能体演示视频管理

🚀 API接口

智能体服务接口

  • CreateAgent: 创建智能体
  • UpdateAgent: 更新智能体
  • GetAgent: 获取智能体详情
  • ListAgents: 获取智能体列表
  • DeleteAgent: 删除智能体

智能体分类接口

  • CreateAgentCategory: 创建智能体分类
  • UpdateAgentCategory: 更新智能体分类
  • GetAgentCategory: 获取智能体分类详情
  • ListAgentCategories: 获取智能体分类列表
  • DeleteAgentCategory: 删除智能体分类
  • GetFeaturedCategory: 获取精选分类

平台资产接口

  • FetchPlatformAsset: 获取平台资产
  • CreateBot: 创建机器人

🔗 外部集成

AI平台集成

  • Coze SDK: 集成Coze平台客户端
  • API Key管理: 安全的API密钥管理
  • 资产同步: 定期同步平台资产
  • 错误处理: 完善的错误处理机制

文件存储

  • 阿里云OSS: 头像、图片等文件存储
  • CDN加速: 静态资源加速访问
  • 安全策略: 文件上传安全验证

📈 性能优化

缓存策略

  • Redis缓存: 热点数据缓存
  • 分类缓存: 智能体分类缓存
  • 配置缓存: 智能体配置缓存

数据库优化

  • 索引优化: 查询性能优化
  • 分页查询: 大数据量分页处理
  • 连接池: 数据库连接池管理

🔒 安全机制

权限控制

  • 租户隔离: 多租户数据隔离
  • 权限验证: 接口权限验证
  • 数据过滤: 数据访问权限控制

安全防护

  • 输入验证: 参数安全验证
  • SQL注入防护: ORM安全查询
  • XSS防护: 输出内容过滤

📚 相关文档