AI教程

AI 代码修改工具给出一段替换文本时，先确认它基于当前文件。原稿已被别人改过，或者同一行出现两处，都可能让替换落在错误位置。

RAG 智能体听到“它的期限呢”时，不能只把这句话送进检索，也不能随意猜“它”指哪份材料。把已确认对象编号放进会话状态，再生成检索问题；新编号冲突时先澄清。

多移动智能体要随领队转向并保持指定队形，先要把“各自站在哪里”写成几何目标。固定的队形偏移属于领队的局部坐标；领队旋转后，偏移也必须旋转，再加上领队的世界位置。只给每个成员的世界坐标加同一个常量，可以平移，却不能实现队形随朝向转动。

从智能体向量数据库撤下一份文档时，只删除一个point可能漏掉其它切片。按开发者确认的doc_id筛选全部相关point，删除前预览ID，删除后回读核对范围。

长文本检索返回很多片段时，不能把串联文本按长度一刀切。可以按确定顺序选择完整片段，放不下的记录ID，避免引用被截成半句。

文档检索命中一段规则，例外条件却在下一段时，可以扩展同文档的相邻段落。扩展前先检查文档身份与顺序，不能把另一个文件的相同序号拼进证据。

三个AI智能体分别整理资料、审查资料、汇总结果时，日志中的本机时间可能不同步，接收顺序也可能变化。要说明“这次接收发生在那次发送之后”，可以在消息里传递Lamport逻辑时钟，并在接收端推进计数。它记录事件顺序约束，不能单凭数字大小证明两条消息有因果关系。

智能体知识库目录可以同时保存相对路径与文件哈希。路径帮助读者找到来源，哈希帮助判断索引是否基于当前字节内容，两者不能互相替代。

知识库维护不要只看文档数量。文档撤下后遗留切片、目录新增版本却没有切片，都可能影响RAG结果。先对照目录与切片索引，输出可回查问题。

AI 爬虫遇到429后，不应立即换身份密集重试。先看Retry-After给出的等待提示，超过任务可接受范围就暂停，并保留失败原因。