Skip to content

Latest commit

 

History

History
364 lines (277 loc) · 8.96 KB

File metadata and controls

364 lines (277 loc) · 8.96 KB

YCode.Vox 智能体对话系统

概述

YCode.Vox 现在支持完整的智能体管理系统,允许用户创建、配置和切换多个AI智能体,每个智能体都有独立的提示词、语音配置和对话记忆。

核心功能

1. 多智能体系统

内置智能体

应用内置了三个专业智能体,开箱即用:

  1. 美式口音智能体 🇺🇸

    • 专注于美式英语表达
    • 适合英语学习和练习
    • 使用自然的美式口语和习惯用语
  2. 通用Work智能体 💼

    • 全能型工作助手
    • 适合日常办公、学习和生产力提升
    • 支持中英文混合交流
  3. 编码智能体 👨‍💻

    • 专业编程助手
    • 精通多种编程语言和框架
    • 提供代码示例和技术建议

注意:内置智能体的核心配置(如系统提示词)不可修改,但可以查看其配置作为参考。

自定义智能体

用户可以创建任意数量的自定义智能体,完全控制其配置:

  • 基础信息:名称、描述、图标(emoji)
  • 提示词:定义智能体的角色、能力和行为
  • 语音配置:自定义中英文TTS语音
  • Temperature:控制回复的创造性(0-2)
  • MCP配置:连接外部工具和数据源
  • Skills配置:添加专业能力模块

2. 供应商系统

智能体和AI供应商完全分离,用户可以自由组合:

支持的供应商

  • OpenAI:GPT-4、GPT-4o、GPT-3.5系列
  • Anthropic Claude:Claude-3 系列
  • Azure OpenAI:企业级服务
  • DeepSeek:高性价比国产模型
  • 智谱AI (GLM):中文理解能力强
  • Moonshot (Kimi):超长上下文支持
  • Ollama:本地部署,无需API Key
  • 自定义API:支持任何OpenAI兼容API

供应商配置

每个供应商配置包含:

  • API Key(如需要)
  • 模型选择
  • 自定义Endpoint(高级选项)

同一个智能体可以使用不同的供应商,只需切换供应商配置即可。

3. 记忆存储系统

每个智能体都有独立的对话记忆:

  • 自动保存:对话历史自动保存到本地存储
  • 智能体隔离:切换智能体会加载对应的对话历史
  • 持久化:浏览器关闭后重新打开,对话历史依然保留
  • 清除记忆:可以随时清除单个智能体的对话历史

4. MCP (Model Context Protocol) 支持

MCP 允许智能体访问外部工具和数据源:

  • 配置多个MCP Server
  • 每个Server可以有独立的command和环境变量
  • 支持任何兼容MCP协议的工具

使用示例

Server Name: File System
Command: node
Arguments: /path/to/mcp-server.js
Environment: {}

5. Skills 技能模块

Skills 是预定义的专业能力模块,可以增强智能体的特定能力:

  • 创建多个技能模块
  • 每个技能有独立的提示词
  • 可以单独启用/禁用
  • 技能提示词会自动附加到系统提示词

使用场景

  • 为编码智能体添加"代码审查"技能
  • 为工作智能体添加"会议纪要"技能
  • 为学习智能体添加"知识总结"技能

使用指南

快速开始

  1. 打开设置

    • 点击右上角设置图标
    • 进入设置面板
  2. 配置供应商

    • 点击"供应商"标签
    • 选择AI供应商(如OpenAI)
    • 输入API Key
    • 选择模型
    • 保存配置
  3. 选择或创建智能体

    • 点击"智能体"标签
    • 选择内置智能体,或点击"创建"按钮
    • 配置智能体属性
    • 保存
  4. 开始对话

    • 关闭设置面板
    • 按住空格说话,或使用底部输入框
    • 每个智能体的对话历史独立保存

创建自定义智能体

1. 基础信息

名称:销售助手
描述:专业的销售话术和客户沟通助手
图标:💼
Temperature:0.7

2. 编写系统提示词

你是一个专业的销售助手,擅长:
- 产品介绍和价值传递
- 客户需求分析
- 异议处理
- 成交技巧

交互风格:
- 专业但不失亲和力
- 善于倾听客户需求
- 提供实用的销售建议
- 适合语音交互的简洁回复

请根据用户的问题,提供专业的销售指导。

3. 配置语音(可选)

选择适合的TTS语音,例如:

  • 中文:zh-CN-YunxiNeural(男声)或 zh-CN-XiaoxiaoNeural(女声)
  • 英文:en-US-GuyNeural(男声)或 en-US-JennyNeural(女声)

4. 添加Skills(可选)

示例技能:

技能名称:客户异议处理
描述:专门处理客户的常见异议
提示词:
当用户提到客户异议时,请:
1. 先理解异议背后的真实顾虑
2. 提供3种不同的应对话术
3. 说明每种话术的适用场景

切换智能体

  1. 打开设置 → 智能体标签
  2. 点击想要使用的智能体卡片
  3. 系统会自动切换并加载对应的对话历史
  4. 关闭设置面板,开始对话

导出和备份

应用配置(包括所有智能体、供应商配置和对话历史)存储在浏览器的 LocalStorage 中:

手动备份

// 打开浏览器控制台,执行:
const config = localStorage.getItem('vox_app_config_v2');
console.log(config);
// 复制输出的JSON字符串保存到文件

恢复备份

// 将备份的JSON字符串赋值给config变量,然后执行:
localStorage.setItem('vox_app_config_v2', config);
// 刷新页面

最佳实践

提示词编写建议

  1. 明确角色定义

    你是一个[角色],专注于[领域]。
    
  2. 列出核心能力

    核心能力:
    - 能力1
    - 能力2
    - 能力3
    
  3. 定义交互风格

    交互风格:
    - 专业且友好
    - 回复简洁(适合语音)
    - 关键信息突出
    
  4. 设置限制和边界

    重要提示:
    - 不要讨论[禁止话题]
    - 保持回复在200字以内
    - 如果不确定,诚实说明
    

智能体设计模式

1. 专家型智能体

专注单一领域,提供深度专业知识

  • Temperature: 0.6-0.7(稳定输出)
  • 详细的专业背景提示词
  • 添加相关的Skills模块

2. 通用助手型

覆盖多个常见场景,灵活应对

  • Temperature: 0.7-0.8(平衡)
  • 包容性的角色定义
  • 明确不同场景的应对策略

3. 创意型智能体

强调创新和发散思维

  • Temperature: 0.8-1.0(更有创造性)
  • 鼓励大胆想法的提示词
  • 适合头脑风暴、创意写作等场景

供应商选择建议

  • OpenAI GPT-4o:最强大的通用能力,适合复杂任务
  • OpenAI GPT-4o-mini:性价比高,适合日常对话
  • Claude-3 Sonnet:长文本理解和分析能力强
  • DeepSeek:国内可用,价格便宜,适合大量调用
  • 智谱GLM-4:中文理解优秀,适合中文场景
  • Ollama:本地部署,完全免费,适合测试和开发

故障排查

智能体切换后没有反应

  • 确认已配置供应商并输入有效的API Key
  • 检查网络连接
  • 查看通知栏的错误提示

对话历史丢失

  • 检查浏览器是否清除了LocalStorage
  • 建议定期备份配置

TTS语音不播放

  • 确认TTS服务已启动(Electron版本内置)
  • 检查TTS endpoint配置
  • 尝试切换不同的语音模型

API调用失败

  • 验证API Key是否正确
  • 检查Endpoint是否可访问
  • 确认选择的模型名称正确
  • 查看供应商账户余额是否充足

技术细节

数据结构

// 智能体配置
interface Agent {
  id: string;
  name: string;
  description: string;
  systemPrompt: string;
  isBuiltIn: boolean;
  icon?: string;
  ttsVoice?: { zhVoice: string; enVoice: string; };
  mcpConfig?: McpConfig;
  skillsConfig?: SkillsConfig;
  temperature?: number;
  createdAt: number;
  updatedAt: number;
}

// 供应商配置
interface ProviderConfig {
  providerId: string;
  apiKey: string;
  selectedModel: string;
  endpoint?: string;
}

// 应用配置
interface AppConfig {
  currentAgentId: string;
  currentProviderConfigId: string;
  agents: Agent[];
  providerConfigs: ProviderConfig[];
  memories: Record<string, ConversationMemory>;
}

存储位置

  • 配置数据localStorage['vox_app_config_v2']
  • TTS配置localStorage['vox_tts_*']
  • 对话记忆:包含在AppConfig中的memories字段

扩展开发

如需扩展功能,主要文件:

  • src/types.ts - 类型定义
  • src/agentConfig.ts - 智能体配置
  • src/providerConfig.ts - 供应商配置
  • src/storage.ts - 存储管理
  • src/components/ - UI组件
  • src/App.tsx - 主应用逻辑

更新日志

v0.2.0 (2026-02-15)

  • ✨ 新增完整的智能体管理系统
  • ✨ 支持多智能体配置和切换
  • ✨ 独立的供应商配置系统
  • ✨ 智能体级别的对话记忆
  • ✨ MCP和Skills配置支持
  • ✨ 内置三个专业智能体
  • 🎨 全新的设置界面和导航
  • 📝 完善的智能体编辑器

反馈和贡献

如有问题或建议,欢迎提交 Issue


享受智能体对话的乐趣! 🚀