A Letaido / docs
DOCUMENTATION

常见问题

第一周会出现的问题。

有问题吗?询问智能体

如果你对 Letaido 能做什么有疑问、遇到错误,或者不确定某个功能如何运作,最快的答案就是直接在聊天中询问智能体。它可以阅读自己的文档、查看你的工作区、检查你的设置,并根据它看到的内容一步步引导你完成操作,而且都在同一个地方。

下面的 FAQ 涵盖了最常见的问题。如果你的问题不在这里,请询问智能体;如果值得保留下来,智能体会主动提出将其添加进去。

基础知识

它会在不同聊天之间记住吗?

是的,但只会记住你让它记住的内容。它会在每次聊天开始时读取 ~/workspace/.memory.md。说 "remember this: X",它就会追加进去。变更日志(progress.md)也会被读取,所以它知道最近构建了什么。

我可以回滚它构建的内容吗?

文件方面很简单:只需询问“显示过去一小时你更改了什么,并还原 X。”数据库更改不会自动还原,但每个操作都会被记录,所以撤销通常可以通过明确的对话完成。对于破坏性更改(删除表、移除技能),智能体会在执行前询问。

多个人可以共享一个工作区吗?

是的。角色包括所有者、管理员、成员和查看者。所有者和管理员决定审批卡、管理密钥,并切换公共站点。成员可以聊天并使用控制台页面。查看者为只读权限。

我输入的任何内容会被发送给第三方吗?

该智能体通过本地代理经由 LLM 提供商进行推理。消息会被发送用于推理,并返回输出。除模型提供商自身政策规定外,不会额外保留任何内容。不会与其他工作区共享任何内容。

当外部 API 失败时会发生什么?

该智能体报告失败(状态码,以及连接器公开的错误类别(如果有)),停止并等待指示。它不会反复重试,直到你的预算爆掉。

构建事物

构建一个 Console 应用需要多长时间?

简单的任务(一个表单、一个查询、一个结果)几分钟内就能完成。复杂的任务(多步骤流程、第三方集成、自定义可视化)需要一次聊天会话,有时需要两次。如果预计需要不止一轮往返沟通,该智能体会告诉你。

如何与客户分享内容?

在公开网站上构建它,获取 URL,将网站模式切换为 openauthorized,分享链接。需要了解的模式:需要令牌访问的报告(/<route>/<token>)、公开文档(此网站)、潜在客户捕获页面。

智能体能构建它以前没有构建过的东西吗?

可以,只要这些基础组件存在(Console 蓝图、站点路由、cron 任务、webhook、connector)。它会将它们组合起来。如果基础组件不存在(需要新的平台能力),它会明确告诉你,而不是假装可以。

如果没有我需要的服务的连接器怎么办?

请联系支持团队为该应用添加新的连接器。新连接器会根据客户请求定期添加;在此期间,该智能体通常可以退回使用通用 API 密钥、域名允许列表和原始 HTTP,但始终首选合适的连接器(它开箱即带类型化输入、日志记录、作用域凭据和按界面审批)。

记忆、技能、语音

如何确保 AI 智能体使用我们的品牌语气?

你的工作区中有一项品牌语调技能。智能体在撰写或审核文案时会读取它。要添加新规则:“update the brand voice skill to add: 。” 要在一次性草稿中强制使用它:“use the brand voice skill before writing.”

为什么你说不要用长破折号?

这是该工作区坚持的内部风格选择。该规则保存在记忆和品牌语气技能中,因此每份草稿(以及这些文档)都会避免使用它们。请改用逗号、冒号、句号或括号。

我应该把所有内容都放入内存吗?

不是。记忆用于那些会改变智能体默认行为的内容:你是谁、你如何写作、你长期关心什么。对于工作流程规则(“我们的标准发布清单是 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_pendingnot_approved

首次出现该 (连接器、密钥、界面) 组合。批准该卡片。对于控制台或站点界面,所有者或管理员会在聊天界面之外单独点击 request_connector_approval

某个任务没有按我预期运行。

Cron 时间采用主机上的 UTC。如果你的作业是“每周一布加勒斯特时间上午 9 点”,计划任务行应为 0 7 * * 1(夏季)或 0 8 * * 1(冬季);代理程序通常会选择其中一个,并在脚本内添加 zoneinfo 保护来处理 DST。请在“作业”标签页查看下次运行时间。

某个触发器未触发。

检查订阅列表。如果显示 pausedrevoked,请重新订阅。如果显示 active 但没有事件,请检查第三方应用配置(订阅 URL 也必须在他们那边设置)。

我的 Workspace 感觉很慢。

长时间的聊天会变差。开始一个新聊天;记忆和进度会把重要上下文带过去。

Last updated 2026-07-15