▎西门子 Eigen 使用指南 · 02：让 AI 读懂你的项目文档
上一篇文章讲了 Eigen 的基础操作：六步启动流程、@符号自动完成、对话管理和提示词优化。如果你已经试过几次对话，可能会发现一个问题——Eigen 虽然能读取你当前打开的 TIA Portal 项目，但它不知道你们公司的编码规范、不了解这个行业的特殊工艺要求、也看不到你手头那份写了一半的需求文档。
这篇文章的内容同样全部来自官方文档，解决的就是这个问题。
一、上传文档：Eigen 的「长期记忆」
要在对话中将文档直接共享给 Eigen 工程智能体，请使用上传功能。这是官方推荐的方式，让 AI 真正理解你的业务背景。
具体操作步骤：
确保已将 TIA Portal 连接到你的对话——这一步是前置条件，没有项目连接就无法上传文档到上下文中。
点击提示窗口左下方的回形针按钮。这是文档入口的视觉标识，在输入框的左下方位置。
在文件资源管理器中导航到所需文档。支持常见的文件格式（PDF、Word、Excel 等）。
点击「打开」（Open）将进入上传确认界面。从「标签」（Label）下拉菜单中选择文档类型。可以从「无」（None）、「样式指南」（Style Guide）和「零件清单」（Parts List）中选择。
文档标签类型说明
| 标签类型 | 适用场景 | Eigen 的处理方式 |
|----------|----------|------------------|
| 无 (None) | 通用文档、工艺说明 | 作为上下文参考 |
| 样式指南 (Style Guide) | 编码规范、命名规则 | 生成代码时强制遵循 |
| 零件清单 (Parts List) | 设备列表、IO 点表 | 用于硬件配置时参考 |
上传过程中，其状态会显示在提示窗口中。完成后，文档将在对话组态视图中显示。要管理所有已上传的文档，请从应用程序菜单中访问「文档」（Documents）部分。
二、组态对话：给 Eigen 设定工作模式
通过点击对话顶部的对话组态按钮，可以为对话分配 TIA Portal 项目或上传文档。这个功能在官方文档中有详细说明。
对话组态分为两个部分：
工程项目
选择你要使用的 TIA Portal 项目。可以点击「选择项目」（Select project）按钮，浏览并选择你的 TIA Portal 项目，即可在此处处理项目。此选择也定义了 TIA Portal 版本。使用 Eigen 时，请确保所选项目已在 TIA Portal 中打开。开始在对话中输入提示词后，所选项目将变为锁定状态，之后无法更改。要处理其他项目，请开始新对话。
已分配文档
本部分提供已分配给此特定对话的所有文档的概览。你也可以选择从此处取消关联现有文档。但是，要分配之前从其他对话上传的文档或删除任何文档，需要使用应用程序菜单中的文档管理功能。
关键细节：项目锁定机制
- 输入提示词之前：可自由切换项目
- 输入提示词之后：项目永久锁定到此对话
- 锁定后想换项目？只能新建对话
- 这就是为什么上一篇强调「选对项目再提问」
组态界面还包含以下区域：
- 文档上传到对话（回形针图标）
- 提示输入字段
- 对话组态的各选项
三、使用自动化框架让 Eigen 按规范干活
如果你的团队使用了西门子自动化框架（Siemens Automation Framework），可以让 Eigen 直接按照 SAF 的结构来生成代码和配置。
要使用西门子自动化框架，你需要将相应的项目模板和项目库添加到你的 TIA Portal 项目中。所有必需信息请访问西门子支持页面。在该页面的底部，你可以看到 TIA Portal 所需的项目文件。此外，该页面还列出了西门子自动化框架前需要满足的所有要求，请务必仔细阅读。
请注意，西门子自动化框架每次请求最多创建 6 个元素，例如单元、设备模块和控制模块。这是一个硬性限制，复杂任务可能需要分批执行。
支持的自动化框架版本为 SAF V2.2。要在 Eigen 中正确使用自动化框架，请确保已相应准备好你的 TIA Portal 项目，并已在组态栏的自动化框架下拉菜单中完成选择。
四、规划模式：让 AI 先想再动手
这是官方文档中一个独特且实用的功能。Eigen 工程智能体可以处理涉及 TIA Portal 复杂变更的高复杂度服务。对于这些任务，你可以将 Eigen 切换到规划模式。
使用方法非常简单：通过在提示词开头输入 / 来激活规划模式。输入 /exit 退出规划模式。
在规划模式下，Eigen 会先输出执行计划供你审核，确认后才真正开始执行。这相当于在 AI 和你的项目之间加了一个「设计评审」环节。
官方文档特别指出，规划模式适用于：
• 多步骤的复杂配置任务
• 涉及多个对象创建或修改的操作
• 需要先确认方案再执行的场合
规划模式 vs 直接执行
| 方式 | 触发方式 | 适用场景 |
|------|----------|----------|
| 直接执行 | 正常输入提示词 | 单一简单任务 |
| 规划模式 | 提示词以 /** 开头 | 复杂多步骤任务 |
| 退出规划 | 输入 /exit | 回到直接执行模式 |
示例触发：「/**
为整条输送线生成完整的 PLC 控制程序」→ Eigen 先输出计划 → 你确认 → 开始执行
五、导出对话记录：从聊天到交付物
如果要将对话记录保存到文件系统，可以使用导出功能。这在实际工程场景中的价值被低估了。
操作步骤：
第一，导航到你想要保存的对话。
第二，打开对话的上下文菜单，点击「导出」（Export）按钮。
第三，对话将保存到常规设置中指定的路径。你可以通过点击底部的导出文件夹图标在文件资源管理器中打开该文件文件夹。
第四，如果要修改对话的保存路径，请点击应用程序菜单中的设置齿轮图标，并在「导出对话存储位置」（Exported Conversations Location）部分输入路径。如果在指定目标路径时出错，将在尝试导出对话时显示错误消息。
导出的对话记录可以用于：项目交接时的知识传递、审计追踪（谁在什么时候做了什么决策）、以及作为培训材料帮助新人理解项目的技术选型理由。另外从合规角度来说，某些行业要求对自动化系统的设计和变更过程有完整的追溯记录，导出功能天然满足这一需求。
六、Eigen 的界面布局速查
最后补充一张 Eigen 主界面的完整布局图，帮助你快速找到每个功能的位置：
Eigen 界面功能区
左侧边栏（应用菜单）：
(1) 展开图标树 — 导航入口
(2) 用户信息 — 登录状态
(3,4) 主菜单栏 — 全局操作
中央主区域（实际对话区）：
(5-7) 底部面板 — 对话核心区
对话区域内部：
(8) 文档上传按钮（回形针）
(9) 提示输入字段
(10) 对话组态按钮
右侧工具区：
(11) 设置与帮助
(12) 新建对话 / 搜索 / 重命名 / 导出 / 删除
七、总结与预告
通过文档上传、对话组态、自动化框架集成、规划模式和导出记录这五个功能，Eigen 已经从一个「能聊天的 AI 插件」进化为一套完整的工程辅助工作流。关键不在于单个功能有多强，而在于它们组合起来形成的协作模式——人负责判断和决策，AI 负责执行和迭代。
下一篇也是本系列的最后一篇，我们会把视角拉到实战：用官方文档中的真实示例提示词，展示 Eigen 在硬件配置、PLC 编程、HMI 设计、驱动参数等场景下的实际表现和能力边界。
如果这篇文章对你有帮助，欢迎点赞、在看、转发。
下一主题
