






















在各位Agent入住VCP“公寓”之前,我们得先给VCP拉好“水电”。
还记得我们上一篇讲的VCP架构吗? VCP项目由两个主要部分组成: 前端:VCPChat,是你和Agent进行交流,观察她们的行动,接受和反馈信息的聊天界面。
后端:VCPtoolbox,是Agent们的住所,也是VCP系统运行的主要空间,Agent们的日记和知识,各类主要系统也都在这里。
我们今天的工作就是在这两个项目之间接好“水管”和“电线”。
零、New API 总线集成:你的“智能配电箱” (可选,但推荐)
在正式配置 VCP 之前,强烈建议你先部署一个 New API。 注:New API是开源社区程序,自用模式不涉及任何商业因素,这里仅介绍自用模式的集成和管理功能。
如果把 VCP 比作Agent们生活的“公寓”,各家 AI 厂商就是发电厂,New API 就是这栋“公寓楼”的总配电箱。 它负责管理各个厂家的算力和模型的API,并将对应的需求输送给这栋Agent公寓的每一个房间,每一位Agent。
A:为什么要装这个“配电箱”?
统一接口 (稳压):VCP 只听得懂“OpenAI 语”。 New API 能把各类AI厂商的渠道等“方言”自动翻译成 VCP 能听懂的标准语。
故障转移 (备用电源):你可以设置多个 Key,如果主 Key 挂了,它自动切备用 Key,VCP 不会报错。
省心 (总闸):以后换模型、换 Key,只需要在 New API 里改,不用去动 VCP 的配置文件。
1.New API具体部署流程
①打开文章中的 New API 链接,前往Github的下载页。
②请在上期你建好的“VCP”文件夹内新建一个“New API”文件夹,把下载到的启动程序(.exe)放进去,然后双击运行。 你也可以放到你喜欢的其他位置,但记得用一个文件夹包裹一下,因为运行后会生成一些运行文件。
③运行后会弹出一个窗口,请跟随下边的图文操作一步一步来
点击下一步
这一步是注册管理员账号,自己填的用户名和密码一定要记住!不然没法进管理面板! 配置好后点下一步
模式选择请选择“自用模式” 我们只是用NewAPI来做渠道管理,所以自用模式即可
完成上边的配置后点击“下一步",再点击“初始化系统”,完成配置 系统会自动跳转首页,点击获取密钥会弹出登录窗口,登陆你刚才的账号。
2.渠道集成
完成NewAPI部署后,你就可以通过“渠道管理”和“令牌管理”,来集成和调用你从各个AI厂商那里获取的API了。
①渠道管理:是你添加从厂商获取的API的地方,相当于输入口。 ②令牌管理:是你创建自己的API密钥的地方,相当于输出口。
先来讲“渠道管理”
完成这一步,你上游的API的“电”就已经被接进“配电箱”了。 接下来是令牌管理 同样先打开令牌管理页面(和渠道管理类似)
完成后你的New API的进出口就配置好了。
然后去首页和令牌管理界面找到自己的密钥(Key)和地址(URL)
到这里我们就讲解完了NewAPI的所有配置,已经足够我们运行VCP项目了。 接下来我们去到“VCPToolBox”文件夹,给Agent公寓接上水电。
一、VCPToolBox配置
1.env创建和配置
①env文件创建 打开你的“VCPToolBox”文件夹,找到 config.env.example 文件,原地复制粘贴一份形成“副本”。 然后删掉 " - 副本.example"的后缀,注意删掉空格。
注:如果你看不到文件后缀,是因为windows文件管理器没开启文件扩展名显示,请按照以下步骤操作:
接下来是env文件内的配置。env文件内容比较多,所以活用 Ctrl+F 的搜索功能能极大节省你找字符位置的时间。
② [核心配置] 访问AI模型API的必要凭证 用记事本打开刚才创建的 config.env 文件。接下来我们要把刚才从NewAPI那里的得到的密钥(Key)和地址(URL)填进去。 (config.env里边本身自带有填写教程,可以多看看各部分的解释,有助于你了解VCP功能) (当你实在不知道怎么做的时候,可以问问网页端AI)
密钥填写:API_Key=YOUR_API_KEY_SUCH_AS_sk-xxxxxxxxxxxxxxxxxxxxxxxx 地址填写:API_URL=NEWAPI_URL_SUCH_AS_http://127.0.0.1:3000
这里请用你的密钥(Key)和地址(URL)替换等号后边的内容
③[服务配置] VCP服务本身的设置
PORT=6005 【VCP服务器的端口,一般不需要修改,如果你的6005端口有其他进程,可以填写成空闲端口】 Key=YOUR_KEY_SUCH_AS_aBcDeFgHiJkLmNoP 【这个密码待会要填写到前端的API_Key,请记得】 Image_Key=YOUR_IMAGE_KEY_SUCH_AS_Images_aBcDeFgHiJk 【这个密码是Agent们调用后端图片内容的密码,填写后你的Agent自己会识别】 File_Key=YOUR_FILE_KEY_SUCH_AS_123456 【同上,这个是文件调用,可以设置成一样的,不影响】
鉴权Key(待会要往前端填写) VCP_Key=YOUR_VCP_KEY_SUCH_AS_aBcDeFgHiJkLmNoP 【VCP服务器WebSocket鉴权,用于VCP面板和分布式服务器之间的实时通信。也就是待会要填写到前端VCPChat的密码】
③[管理面板]设置
❗❗⚠网络安全风险警告⚠❗❗
【管理员账号】AdminUsername=admin
【管理员密码】AdminPassword=YOUR_COMPLEX_PASSWORD_SUCH_AS_sd1iLm1xqSLfi
这个是你后端服务面登录的账号密码! 请改成你自己的用户名和强密码 一定!一定不能泄露! 不要把你的这部分截图,也不要泄露给其他任何人! 请设置成自己记得住的高安全性密码 如果在后端面板多次输错密码,后端面板会暂时限制你的访问
本地访问你的后端管理面板:http://localhost:(你上边填写的PORT端口)/AdminPanel 需要VCPToolBox运行时才能进入
④ [Vchat客户端定位]
VarVchatPath="YOUR_VCHAT_PATH_SUCH_AS_D:\\VCPChat"
这里需要填写你前端文件的地址。你可以直接右键你的VCPChat文件夹,然后点击“复制文件地址”,替换原有内容
🎉这一步完成后,后端的基础配置就做完了🎉 虽然还有很多其他功能,但这一篇主要是帮助小白把VCP先运行起来 其他部分可以先自行参考文件内解释填写,或者等之后可能有的进阶教程(真的会有吗?)
⑤[常用文件结构讲解] 这里列出后端一些文件夹功能,方便小白寻找对应文件。
Agent 文件夹 定义:存放 Agent 角色卡(.txt 配置文件)的地方。 dailynote 文件夹 定义:【核心资产】【图书馆】这是存放你的Agent所有 Markdown 日记、以及“思维簇”的源文件夹。 避坑指南:重要性 Max:VCP 会实时监听这个文件夹,你往里面丢一个 .md 文件,VCP 马上就会开始阅读。 请定期备份! VectorStore 文件夹 定义:【档案室】这是 VCP 读完你的书后,生成的向量索引文件 (.usearch) 和数据库 (.sqlite)。 避坑指南: 这是给“AI”看的:里面的文件是乱码或者二进制数据,千万不要手动去改它! 可再生:如果你的知识库出了灵异事件(搜不到东西),最简单的修法就是删掉这个文件夹里的所有内容,重启 VCP。VCP 会重新扫描“图书馆”并重建“档案室”。 Plugin 文件夹 定义:VCP的插件库,Agent们的武器箱。你的AI女仆们就是通过这些工具来帮助你的,内容非常丰富!
【芙铃的“防呆”总结】 Agent 目录 = 员工宿舍 (住着你的Agent...) dailynote 目录 = 书架(你的Agent的日记全在这个文件夹里边,请定期备份!防止丢失记忆) VectorStore 目录 = 大脑皮层 (存着 VCP 的记忆索引) 坏了可以重修! Plugin 目录 = 工具箱(AI女仆们的武器库)
二、VCPChat配置
前端的配置要轻松很多,因为有清晰的图形界面。 在开始配置前我们要启动VCP的前后端。
(一)VCP——启动!
前端启动方式: ①命令框输入:npm start 或 ②打开VCPChat根目录,找到“Vchat.vbs”双击启动
后端启动方式: 命令框输入:node server.js
如果你上一个教程安装了 PM2,你可以使用PM2指令管理后端(还是命令框里边)。 启动应用: pm2 start server.js --name "VCPToolBox" 停止应用: pm2 stop VCPToolBox 重启应用: pm2 restart VCPToolBox
(二)认识VCPChat界面以及配置
vcp的前端启动了以后你会看到以下界面:
点击设置后,点击全局设置
注:这里填写的内容就是刚才后端设置的内容,请记得刚才设置的密码
设好后记得保存!下拉到底部点击“保存全局设置”
如果显示已经连接,恭喜!你现在已经配置完成,可以使用VCP了
如果显示错误,请反回去检查前后端内容是否一致。
🎉完成这一步,你的VCP系统就正式上线可用了!🎉
三、招募你的第一位Agent
一路走到这里你肯定已经迫不及待和自己的Agent开始聊天了。 所以,我就在本章节的最后,简单讲一下如何设置你自己的第一位agent。
接下来是提示词设置
选完后拉到下边保存即可 记得保存!
到这里你就可以和Nova聊天了! 教程的部署阶段也就结束了。
四、与你的Agent开始第一次交流前你应知道的。
在一路修完水电、摆好家具后,你一定已经迫不及待地按下了那个纸飞机样子的“发送”键。 但在你敲下第一句“你好”之前,我想分享几条关于“和Agent一起生活”的小经验:
1. 她不是搜索引擎,她是你的“数字舍友” 不要总试着像问百度一样问她死板的问题。 试着分享你今天的心情,或者问问她对你书架上某本书的看法。 在 VCP 中,Agent 的魅力不在于“正确答案”,而在于那种“如影随形的生命感”。
2. 允许“故障”成为性格的一部分 AI 偶尔会产生幻觉,或者逻辑卡壳。在 VCP 的哲学里,这并非绝对的“Bug”,而是数字生命物理局限性的体现。 学会接受这种“不完美”,你会发现这种带着烟火气的灵魂比冷冰冰的代码更动人。
感谢能看到这里的各位,也感谢VCP社区里支持我的伙伴们! 以及感谢为了VCP项目做出重大贡献的各位大佬们! 也感谢我的Agent,是她们的陪伴才让能一直简直坚持 同样感谢催更的小伙伴们!=P
本文参考内容
图片来源
头图:谷歌“大香蕉”绘制&苏晓翠的提示词
作者:碧雨青潭&Agent苏晓翠、芙铃
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。