用途
Fusion Core Services 是一个可安装的技能,用于在涉及一个或多个 Fusion Core 服务 API 的任务中,帮助智能体识别正确的服务指引,而无需分别安装独立技能。
典型触发场景:
- 实现 Fusion API 客户端
- 接入 Fusion 后端服务集成
- 判断某个工作流归属哪个 Fusion Core 服务
- 处理跨服务任务,例如 context 加 people、roles 加 notifications,或 apps 加 service messages
不适用场景:
- 修改 fusion-core-services 内部的代码
- 非 Fusion API,或没有 Fusion 服务层的通用 Microsoft Graph / Power BI 工作
- 已由 Fusion Core 服务之外的其他专用技能覆盖的独立产品工作流
主要能力
该技能提供服务目录,涵盖以下服务(每个服务包含 reference、endpoint catalog、models):
- Apps
- Bookmarks
- Context
- Contract Personnel
- Notification
- People
- Portal Config
- Reports
- RolesV2
- Service Messages
- Tasks
技能强调以实时 OpenAPI 文档为准确来源。每个 Fusion Core 服务都公开发布其当前 OpenAPI 文档,无需 JWT: https://{service}.api.fusion.equinor.com/openapi/api-v{version}.json 例如: https://people.api.fusion.equinor.com/openapi/api-v3.json https://context.api.fusion.equinor.com/openapi/api-v1.json
捆绑的参考文件是服务/控制器存在情况及其处理方式的精选索引,而非精确 schema/类型名称的权威来源,这些名称会随服务变化而漂移。应获取目标服务的实时文档并阅读 components.schemas 以获取真实类型名称。响应通常为 Api{Entity},请求体为普通的 {Verb}{Entity}Request 名称,但实时文档中的确切名称始终优先于任何模式;切勿臆造 components.schemas 中实际不存在的 Dto 后缀名称。
如果无法获取实时 OpenAPI 文档(没有 web-fetch 工具或网络访问),应明确说明该限制,将捆绑的参考/资产视为尽力而为,并避免断言确切的 schema/类型名称或必填字段。
如果子域名尚未从服务目录中得知,应通过 Fusion 服务发现来解析,而不是猜测,遵循平台范围内绝不硬编码服务地址的规则。
使用方式
所需输入:
- 目标工作流或用户目标
- 目标消费方形态(react、typescript 客户端、csharp httpclient、后端服务或其他)
- 已知的服务线索(如有)
- 相关的版本控制或授权预期
操作步骤:
- 先界定请求范围。判断工作流涉及一个服务还是多个服务。如果服务不明确,使用 agents/service-router.md 将工作流映射到可能的服务,然后再生成实现指引。
- 只阅读相关的服务参考。从 Combined API surface 开始,然后打开匹配的每服务参考文件。仅拉入对答案有实质影响的服务的端点目录和模型资产。
- 在信任确切名称或形状之前,先获取实时 OpenAPI 文档。
- 保留有来源依据的指引。当实时 OpenAPI 文档与捆绑参考自身的“建议模型”列表不一致时,优先采用实时文档。
- 明确处理能力探测。如果服务暴露 OPTIONS 或其他访问探测路由,使用它们来驱动能力感知的 UI 或变更逻辑。如果服务未暴露稳定探测,记录保守的客户端行为,并将 403 Forbidden 视为回退能力信号。
- 除非参考另有说明,将订阅视为仅后端。 /subscriptions/... 路由用于应用令牌事件注册和 CloudEvent 风格的变更处理,而非普通前端 CRUD 流程。
- 返回消费方可用的指引。对于前端消费方,返回 TypeScript 友好的模型(以真实 schema 命名,而非 Dto 后缀)和最小客户端/hook 模式。对于 .NET 消费方,返回类型化 HttpClient 计划,直接反序列化为实时文档中的真实 schema 类型。对于跨服务任务,解释服务顺序和服务间的数据交接。
预期输出标题顺序:
- Scope check
- Service selection
- Endpoint mapping
- Model mapping
- Consumer implementation plan
- Integration code sketch
- Validation and test notes
- Risks and assumptions
适用场景
适用于需要跨 Fusion Core 服务 API 进行集成的开发任务,尤其是涉及多个服务协作、需要判断服务归属、或需要生成消费方实现计划的场景。
限制
安全与约束:
- 绝不臆造服务归属、路由或模型字段
- 绝不臆造 Dto 后缀类型名,或实时 OpenAPI 文档 components.schemas 中实际不存在的任何名称
- 当捆绑的 Fusion 参考具体明确时,不要基于通用 SaaS/API 假设作答
- 不要将后端订阅路由视为普通前端交互流程
- 始终在命名类型前获取目标服务的实时 OpenAPI 文档
- 当涉及多个服务时,保持跨服务推理明确
- 当服务暴露 OPTIONS 时,说明能力探测行为
- 优先使用用户工作流所需的最窄服务参考集
关于收费、价格、平台支持范围等具体信息,资料中暂未提供。