先把你那个 Cloud 平台的免费账号好好的给注册出来, 然后呢, 你要把这个注册的页面给打开。/auth/sign-up/-user选免费版就够用了。注册完会分配给你一个stack后面所有地址都跟这个stack相关记好它。在进行第二步的时候, 需要把插件安装进去。在进行安装操作之前, 首先需要确认你正在运行的运行环境究竟是怎样的具体情况, 通过执行 which 命令来查看当前路径的具体位置信息之后, 再把需要安装的各个部分统统装进同一个运行环境里面去, 以此来避免出现因为环境不一致而导致的误装情况。------pip --------这个插件的要求是必须要使用3.11及以上的版本, 但是现在大家基本上使用的都是新一些的环境, 所以应该没有什么问题。在安装完成之后, 你可以去确认一下具体的版本号是不是符合要求。------pip show --------你要是能看到是0.10.0这种情况的话, 那就是正确的结果了。第三步嘛, 就是需要在那个yaml格式的文件里面, 去把相应的功能给开启起来。程序虽然已经安装好了, 但是它还是不能立即使用, 你需要到软件配置的地方去把它开启。具体的做法是, 先去打开你电脑里头的那个配置文件, 根据我这边显示的路径~/./.yaml 来操作, 然后在文件里面找到对应的这一段内容, 接着把这个原本写的是空列表的部分进行修改, 把它改成下面的样子:------::-------这里有个坑必须先说的 这个CLI命令现在还看不到pip装的插件它只扫 ~/.// 目录。所以别指望用命令启用直接改YAML最稳。同样 list 也看不到它——不是你装错了是它本来就不走那条路验证要看第五步。把凭证填进环境变量, 这就第四步了。接下来要前往你的stack, 以便取得相应的凭证, 这时候需要打开这个具体的地址链接, 注意把其中的“stack”替换为你个人的专属名称。------https://你的/a/--app/setup------在设置这个页面里面点击 token 这个选项, 接着再点击 Copy as 这个按钮, 这时候屏幕里就会复制出一大段环境变量。你需要把这段文字存进一个叫做~/./.env 的文件里, 程序启动的时候会去读取这个文件, 而且它里面的内容比 shell 环境里那些名字一样的变量还要厉害优先级更高一点:------你的http这代表的就是你所采用的那个验证身份的途径。那个T_ID呢, 指的是你的租户ID这个事儿。你的token你的/otlp你的OTLP请求头------你要知道, 上面所显示的内容仅仅只是一个用于占位的示意性说明, 你在进行实际操作的时候, 必须把你从其他地方复制过来的具体内容原原本本地填进去, 绝对不要直接照抄我在这里所写的文字内容。到了第五个步调, 也就是该怎么去核实是否已经成功安装完成这回事。在完成配置的更改之后, 重新启动服务, 并且使用调试模式运行一次:------true------接着的话, 你可以去查看位于路径~/ ./ logs / agent.log 的这个文件, 在文件内容里面基本上是可以看到包含这三行的信息的, 当你看到了这些内容之后, 从某种意义上来说, 事情就基本上已经完成了一半了。--------: with OTLP HTTP--: with OTLP HTTP这是一个关于 otel 的表达式, 其中包含一个等号和一个括号。------在此刻, 只要随便是去安排完成某些工作任务, 随后是展开从 Cloud 开始一直到以两个箭头指向最终的 Agent 这一操作路径之后, 即是能够见到这次对话内容是被记录为若干单条的记录。当你在完成安装操作以后, 你必须要去重点关注并时刻留意这3个数字。大家把数据展现出来的目的, 不是为了仅供阅览和观赏, 而是为了支持最终的决策制定操作。所以我在实际操作的建议层面, 主张大家在初始接触阶段务必重点监测并把控核心数值内容:每次对话的平均响应时长这个问题, 如果在发现某类任务比其他的同类任务要慢上非常多的时候, 通常情况下, 这大半是因为工具在不停地反复重试着调用操作, 或者是有哪一个具体的步骤在那里干巴巴地等着系统超时, 这时候只要顺着那条曲线的走势去查看一遍, 就能非常容易地找到并确定到底是处于哪一个环节卡住了。当调用工具的时候出现失败, 这种状况对于智能体来说, 偶发性的意外是完全属于正常范围内的现象, 不过要是发现失败的次数都堆在了某一个具体的工具上面, 那么就必须认真去检查那个工具的设定参数以及网络连接的状况, 因为这个数字能够直接表明到底是有哪个工具在拖后腿。关于token所消耗数量的最高峰值情况的那一段对话而言, 你需要去查找出哪些条数的对话在最消耗token的这些内容, 然后检查一下这些对话中究竟是系统提示词的长度是否过长呢, 还是说的历史记录没有得到及时的清理和删除操作。这一点是进行省钱工作的首要关键点和重点环节, 特别是对于那些正在使用API服务并按照实际消耗数量来支付费用的朋友们来说更是如此。把这三个数值定下来之后, 你在调整配置的时候, 就不再是凭那种没有任何依据的主观猜测去操作了。具体做法是先记录一组基准数据作为对比参照, 然后在修改完毕之后去观察监测曲线的变化趋势看看是否有改善, 监控系统真正核心的作用和价值就体现在这里面——它能够使得每一次进行优化工作的过程都有实际可验证的依据在背后支撑着。在意隐私一行配置的事在前面那个部分, 我们已经讲过了, 系统默认的设定是会将完整的内容都记录下来。如果你不希望提示词、也就是回复以及工具的入参和出参这些东西离开你自己的那一台计算机设备的话, 只需要添加一个环境变量的配置就可以了:------------当你把这个设置好之后, 照常调用是会被记录的, 但是回复内容还有工具数据是不会上传的, 所以你还是能够清楚地看到是谁在什么时间点调用了什么功能, 以及消耗了多长时间。请把这两种模式拿来对比一下:在对配置内容执行上传统作以后, 将会生成一份相应的统计记录。默认不设置完整内容有不上传有我建议, 等到第一次运行程序并且数据被成功跑出来之后, 就把那个功能给打开, 因为用来进行日常的调整和改善, 统计数据方面的信息已经是完全能够满足需求了。避坑清单最后咱们对前面几处被具体指出的那些存在的问题点进行汇总。如果你是使用-zone-shot标志来进行运行的, 那么这种一次性模式不会把任何东西保留下来。整个运行过程将会关闭日志功能, 从而导致上文所提及的那些数据记录完全地一个都不会产生出来。为了能够查看到具体的数据情况, 你必须选择开通交互式模式才行。这是一个老用户升级的情况, 之前安装过是叫作sigil的那个东西的, 必须得先把旧包去掉了再去装新的, 不然的话两个插件会同时注册的, 在那个yaml文件里的key要从sigil改成开头, 开头的这些环境变量也要改成开头。不要使用CLI来启用, 因为对于pip插件来说, 相关的命令以及list操作都是「看不见的」, 通过修改YAML文件加上查看数据, 这才是用来验证的正确方式。环境必须是适合的, 插件要求的是3.11以及更高的版本, 而且必须安装到相同类型的环境中去, 如果安装到了错误的环境之中, 插件会静默失效。总结关于给人工智能智能体安装监控这一项工作, 其实前期只需要花费半小时的时间, 换来的是在之后每次进行调优的时候, 都有实实在在的数据作为支持和依靠, 究竟token是在哪个地方被消耗掉的具体是哪一次工具调用出现了没有报错却实际失败的静默情况, 或者是哪一道环节导致了响应速度的变慢, 这些信息通过监控都可以一眼就清晰地检查出来, 这对于那些每天都要跟这个系统打交道的人来说, 真的属于一种越早知道就应该越早去安装的必要配置。这个插件是社区里头开源出来的产品, 它刚刚被发布出来, 目前的状态还是处在快速迭代的阶段, 所以在开始动手操作之前, 大家最好去看一眼看看是不是有新的更新内容出来, 对于个人用户来说, 免费使用额度是完全足够用的, 所以我们建议你先通过测试把这个流程给跑通, 然后再去谈申请增加额度的问题。请不要在人工智能的发展浪潮当中落下阵脚, 请关注我, 我们一起去获取在人工智能时代里面的各种好处和利益。