从业务现场,到可复用的企业能力。FORWARD-DEPLOYED ENGINEERING
FDE 学院
WEEK 01 / PRACTITIONER NOTES

FDE 职责与项目判断

立项评估 · 客户决策链 · Fit/Gap · 环境自检

01分周讲义
8 个讲义单元约 2.6 千字中文正文含工程示例、作业与验收下载本周完整讲义 ↓
FIELD JOURNAL / 01现场与判断

先用图解理解结构,再结合正文实现与验证。

现场与判断
本周交付物

项目判断书、适配清单与自检记录

按讲义完成实现并提交证据。代码片段、模拟结果与真实模型任务需要分别标注。

1. 学员身份与项目背景

这门课训练的是产品方 FDE:你所在的团队已经有一个 Agent 产品,现在需要把它部署到一家企业,使它能够读取正确的数据、理解业务口径,并在授权范围内完成工作。你的主要任务不是再造聊天界面,也不是把客户说的每句话都变成功能,而是找出标准产品与客户实际工作之间的差距,决定哪些通过配置解决,哪些需要开发,哪些应回到产品团队处理。

贯穿课程的项目是一个虚构的连锁零售会员运营项目。经营负责人希望改善会员复购,运营人员每周手工拼接 CRM 和 POS 报表,门店认为总部推荐的人群不准确,IT 担心接口和数据权限。你先交付能够查询、分群、解释建议的 Agent v1,再根据评估结果扩展为可以受控发券、打标签的 Agent v2。零售只是练习载体:后续还要说明同样的方法迁移到销售研究、知识服务和供应链时需要改动什么。

课程采用“已有产品 + 客户扩展”的架构约束,但本站没有附带第三方商业 Agent 平台。下载包是 Python 标准库教学脚手架;浏览器实验采用预设逻辑。它们用来验证数据和控制机制,不能证明真实模型的理解、规划或工具选择能力。接入真实模型、提交任务轨迹是工程作业的一部分。

2. FDE 的职责:对交付负责,也对产品边界负责

FDE 需要同时处理三个问题:这件事是否值得做;当前产品能否在客户约束下完成;这次交付能为下一次留下什么。只完成第一项容易停在咨询报告,只完成第二项容易变成没有业务目标的开发,只完成第三项则可能为了抽象而抽象,错过当期交付。

协作角色通常负责什么FDE 必须与其明确的接口
售前与商务商机、采购流程、商业承诺演示能力是否等于可交付能力,哪些承诺需要验证
产品与研发通用能力、版本和产品路线客户扩展点、缺陷归属、补丁回收方式
业务负责人业务目标、使用资源和验收谁提供基线、谁评判建议质量、谁承担业务决策
IT 与安全系统接入、身份权限、运行要求接口负责人、测试环境、数据流、上线窗口
客户成功与运维采用、续用、故障和服务衔接交接内容、响应边界、效果复盘周期

这些是协作分工,不是职业高低排序。外包工程师同样可能对结果负责,FDE 也可能采用项目制合同。判断工作的性质,要看是否参与问题定义、是否完成生产适配、是否将经验反馈为可复用能力,而不是看岗位名称。

AIelsen / FIELD BOARD · W01
01.1
先判断差距,再选择交付方式

把需求放在产品能力、可配置扩展与产品缺口之间,决定接入、验证或暂缓。

3. 立项前必须回答的四个问题

为什么现在做? 要求客户提供最近一次具体事件:什么时候做了什么决定,依赖哪些信息,哪里出现延误或错误,造成了什么后果。“我们要拥抱 AI”不是可验收的项目目标。

谁能决定? 区分预算拥有者、采购签约者、业务验收者、实际使用者。职位高不代表了解实际流程,使用频繁也不代表有预算权。画出决策链,并约定哪些人需要参加后续评审。

资源从哪里来? 预算只是资源的一部分。还需要数据样本、接口权限、业务专家时间、测试账户、上线窗口和运行负责人。没有这些条件,即使合同已签,项目仍可能无法验证。

怎样算成功? 先写可观察的成功条件,不急着报一个百分比。例如:“运营人员能在授权门店范围内生成可解释的候选人群;候选人群与冻结口径重算一致;未满足条件时系统能够澄清或拒绝。”业务结果指标在第 3 周进一步定义,不能把系统可用等同于复购提升。

4. 用四项判断形成立项结论

判断项需要的证据典型阻断下一步验证
技术可行性样本、接口、运行环境、产品自检核心数据无法获得或必要接口不可用先验证一个最小读链路
业务价值任务频次、现有耗时、决策损失没有实际使用任务,只有展示需求观察一次完整业务操作
客户适配负责人、参与时间、使用场景无人评判好坏,或决策角色长期缺席约定评审机制再继续
交付风险安全要求、范围、依赖、周期未授权数据处理或无法控制的关键依赖暂缓受影响部分并提出替代路径

不要将四项简单求平均。高业务价值不能抵消无数据权限;接口演示成功也不能抵消无人使用。结论分为继续、条件性继续、暂缓,并附触发条件、证据负责人和复查日期。“条件性继续”应明确允许进行的工作,例如只使用合成数据搭建适配器,而不是默认可以使用真实数据。

5. Fit/Gap:把需求转成产品与交付的工作清单

假设客户提出“识别沉默会员并自动发券”。应先拆成身份映射、指标计算、人群选择、建议生成、权限确认、发券连接器、结果回查等能力,再逐项判断,而不是把整句话归为一个“大需求”。

分类本课示例处理方式
标准支持产品已有会话与工具注册接口运行版本自检,不重复开发
配置支持工具开关、模型配置、租户参数配置入版本库,记录默认值与影响
客户适配CRM 的 legacy_member_id 映射写适配器和数据契约测试
产品缺口确认记录无法绑定具体动作参数提出通用扩展接口及回归测试
本期不支持未验证效果就要求全量无人值守发券写入范围排除与后续条件

最容易犯的错误,是把客户 ID、优惠策略、内部字段直接写进产品核心。这样虽能快速演示,却使升级和第二个客户交付都变得困难。反过来,也不要为一个客户尚未验证的需求立即设计通用平台。先隔离适配,出现第二个样本后再检验抽象是否稳定。

AIelsen / FIELD BOARD · W01
01.2
客户差异应该放在哪一层

客户适配、行业资产与产品核心分层管理。一次交付可以反馈产品,不等于把客户逻辑写入核心。

6. 工程起点:版本自检与扩展目录

下面是建议的项目边界示意,不是下载包已经实现的商业产品目录。core 代表你选择或获授权使用的标准运行时,tenant_extensions 是本次作业主要修改范围。

TEXT 教学示例 / TEACHING EXAMPLE
core/                      # 会话、模型适配、工具注册、基础 trace
tenant_extensions/retail/
  data_adapter.py          # 客户字段 → 标准数据契约
  ontology.json            # 对象、关系、动作与版本
  metrics.sql              # 可重算的业务指标
  tools.py                 # 分群、建议、受控动作
  policies.json            # 字段、范围、动作约束
evals/                     # 数据、工具、模型任务分开评估
delivery/                  # 范围、决策、上线、验收材料

先运行下载包的 python -m unittest discover -s tests -v。保存解释器版本、测试命令、退出码和关键结果;记录哪些测试验证机制,哪些能力尚未实现。真实项目还应分别自检数据库、模型凭据、工具调用和日志写入,但不要把密钥或真实数据写入运行记录。某项不可用时应报告明确状态,不要把异常吞掉后显示“环境正常”。

7. 案例研读:部署能力为什么成为独立能力

阅读 Deployment Company 案例拆解。公开交付模式从业务诊断和少量优先工作流开始,让工程师进入客户环境,连接数据、工具与控制机制,再将现场经验反馈给产品。案例的关键问题是:标准模型能力如何变成每天有人使用、有人维护的工作系统?

本周按 FDE 角色进行推演:先重放一次运营任务,记录取数、身份匹配、建议形成与接手过程;再用失败样本区分配置缺口、客户适配和产品共性问题。对“同一会员出现两个身份”的合成需求,先交付冲突样本与映射规则,不急于扩大自动触达。

提交三项结果:一个优先工作流及不做清单、一张带证据的 Fit/Gap 表、一项最小验证。评审者应能看出继续投入需要什么条件,以及哪个问题应由客户数据负责人、FDE 或核心产品团队解决。

8. 必做作业、思考与验收

必做:选择三个候选任务,为每项记录一次具体失败事件;完成四项立项判断和五类 Fit/Gap;运行教学包并提交环境自检记录。最后用一页项目判断书说明选定哪项任务、为什么暂不做另外两项,以及尚未获得的资源。

思考:如果商务希望你在演示中称为“已经支持自动运营”,而你只验证了只读分析,如何准确表达当前能力,并提出能够推进商机的下一步?写一段可直接用于项目会议的回答,不只写“拒绝承诺”。

进阶:为一个标准产品编写自检脚本,将每项依赖输出为 pass / fail / not_configured,并说明一个失败会影响哪些能力。

验收要求:评审者应能从文档找到原始证据、继续条件和责任角色;Fit/Gap 至少包含一项客户适配和一项明确不承诺的能力;自检结果不得把脚本模拟标为真实模型验证;下一周访谈对象与待确认问题可由另一位同学直接执行。

本周自测与学习记录

客户价值评分很高,但样本没有授权。下一步?

参考与进一步阅读

OpenAI ↗ · OpenAI Deployment Company2026-05-11 · OpenAIAnthropic ↗ · Building effective agents2024-12-19 · Anthropic

结合本周作业阅读原文,记录影响设计的约束与验证方法。技术规范请核对实际部署版本。

教学画板
下载 SVG ↓

搜索在本机执行,不上传输入内容。