常见问题
第一周会出现的问题。
有问题吗?询问智能体
如果你对 Letaido 能做什么有疑问、遇到错误,或者不确定某个功能如何运作,最快的答案就是直接在聊天中询问智能体。它可以阅读自己的文档、查看你的工作区、检查你的设置,并根据它看到的内容一步步引导你完成操作,而且都在同一个地方。
下面的 FAQ 涵盖了最常见的问题。如果你的问题不在这里,请询问智能体;如果值得保留下来,智能体会主动提出将其添加进去。
基础知识
它会在不同聊天之间记住吗?
是的,但只会记住你让它记住的内容。它会在每次聊天开始时读取 ~/workspace/.memory.md。说 "remember this: X",它就会追加进去。变更日志(progress.md)也会被读取,所以它知道最近构建了什么。
我可以回滚它构建的内容吗?
文件方面很简单:只需询问“显示过去一小时你更改了什么,并还原 X。”数据库更改不会自动还原,但每个操作都会被记录,所以撤销通常可以通过明确的对话完成。对于破坏性更改(删除表、移除技能),智能体会在执行前询问。
多个人可以共享一个工作区吗?
是的。角色包括所有者、管理员、成员和查看者。所有者和管理员决定审批卡、管理密钥,并切换公共站点。成员可以聊天并使用控制台页面。查看者为只读权限。
我输入的任何内容会被发送给第三方吗?
该智能体通过本地代理经由 LLM 提供商进行推理。消息会被发送用于推理,并返回输出。除模型提供商自身政策规定外,不会额外保留任何内容。不会与其他工作区共享任何内容。
当外部 API 失败时会发生什么?
该智能体报告失败(状态码,以及连接器公开的错误类别(如果有)),停止并等待指示。它不会反复重试,直到你的预算爆掉。
构建事物
构建一个 Console 应用需要多长时间?
简单的任务(一个表单、一个查询、一个结果)几分钟内就能完成。复杂的任务(多步骤流程、第三方集成、自定义可视化)需要一次聊天会话,有时需要两次。如果预计需要不止一轮往返沟通,该智能体会告诉你。
如何与客户分享内容?
在公开网站上构建它,获取 URL,将网站模式切换为 open 或 authorized,分享链接。需要了解的模式:需要令牌访问的报告(/<route>/<token>)、公开文档(此网站)、潜在客户捕获页面。
智能体能构建它以前没有构建过的东西吗?
可以,只要这些基础组件存在(Console 蓝图、站点路由、cron 任务、webhook、connector)。它会将它们组合起来。如果基础组件不存在(需要新的平台能力),它会明确告诉你,而不是假装可以。
如果没有我需要的服务的连接器怎么办?
请联系支持团队为该应用添加新的连接器。新连接器会根据客户请求定期添加;在此期间,该智能体通常可以退回使用通用 API 密钥、域名允许列表和原始 HTTP,但始终首选合适的连接器(它开箱即带类型化输入、日志记录、作用域凭据和按界面审批)。
记忆、技能、语音
如何确保 AI 智能体使用我们的品牌语气?
你的工作区中有一项品牌语调技能。智能体在撰写或审核文案时会读取它。要添加新规则:“update the brand voice skill to add:
为什么你说不要用长破折号?
这是该工作区坚持的内部风格选择。该规则保存在记忆和品牌语气技能中,因此每份草稿(以及这些文档)都会避免使用它们。请改用逗号、冒号、句号或括号。
我应该把所有内容都放入内存吗?
不是。记忆用于那些会改变智能体默认行为的内容:你是谁、你如何写作、你长期关心什么。对于工作流程规则(“我们的标准发布清单是 X”),技能更合适。对于一次性上下文(“这位客户对定价很敏感”),在聊天中说明即可。
公共站点、文档、每周摘要
这些文档是如何更新的?
Markdown 源文件位于 ~/workspace/docs/*.md。维护者手动编辑。同步任务(每 30 分钟一次)会将 Markdown 渲染到数据库中。公开站点从数据库读取内容。
什么是每周摘要?
一个定时任务,每周一 10:00(Europe/Bucharest)运行。它会比较自上次摘要以来智能体的记忆、变更日志和 skills 文件夹的差异,询问 LLM 有哪些客户应该知道的变化,并通过 Slack 将建议的文档编辑发送给维护者。维护者审核;文档随即更新。
为什么不直接自动发布这些建议?
两个原因。(1) LLM 建议的编辑可能会有细微错误;文档是产品的公开门面。(2) 人工审核能保持语气一致,并发现那些看起来正确但实际不对的内容。
如何报告文档中的问题?
在聊天中告诉智能体。它会在工作区中打开一条备注,并在下一期每周摘要中将其呈现给文档维护者。
审批、密钥、资金
为什么它一直要求我批准操作?
因为该操作会花钱、访问网络,或涉及凭据。每个操作都会被记录。解决“太多批准卡片”的办法通常是批量处理请求:先让智能体规划整个流程,这样它就能一次性请求所有权限范围和批准。
我可以查看已配置的凭据吗?
可以,从工作区 UI 中查看。你可以看到机密的名称、类型、状态,以及它被授权给哪些连接器和界面。你看不到机密值;任何人都看不到,包括该智能体。
我可以限制智能体的支出速率吗?
平台会计量 LLM 令牌和连接器调用。为了持续控制成本,作业是合适的管理入口(它们是明确的周期性支出);临时聊天支出则取决于你提出的请求。如果某个作业运行异常,请在 Jobs 标签页中暂停它。
故障排除
公开视频 URL 返回 403。
网站模式为 off。请在公共网站标签页中切换为 authorized(仅成员)或 open(任何人)。
Console 页面一直加载。
要么该页面正在执行一次很长的外部调用(nginx 超时时间为 30 秒;耗时较长的工作应使用 job-id-then-poll 模式),要么 Flask 进程已经崩溃。检查 /home/console/http/data/.tail.log 中的 tailed 日志。
连接器调用返回 approval_pending 或 not_approved。
首次出现该 (连接器、密钥、界面) 组合。批准该卡片。对于控制台或站点界面,所有者或管理员会在聊天界面之外单独点击 request_connector_approval。
某个任务没有按我预期运行。
Cron 时间采用主机上的 UTC。如果你的作业是“每周一布加勒斯特时间上午 9 点”,计划任务行应为 0 7 * * 1(夏季)或 0 8 * * 1(冬季);代理程序通常会选择其中一个,并在脚本内添加 zoneinfo 保护来处理 DST。请在“作业”标签页查看下次运行时间。
某个触发器未触发。
检查订阅列表。如果显示 paused 或 revoked,请重新订阅。如果显示 active 但没有事件,请检查第三方应用配置(订阅 URL 也必须在他们那边设置)。
我的 Workspace 感觉很慢。
长时间的聊天会变差。开始一个新聊天;记忆和进度会把重要上下文带过去。