需要复用 Celigo Marketplace…

在 Celigo Marketplace 中浏览、安装或复用 Template、Integration App 或其中单个 flow/export/import/script 时使用。

适用场景

解决思路

1. 在安装前先搜索账户，避免重复已有集成或连接：运行 `celigo account search "<keyword>"`。
2. 浏览 marketplace 目录并注意每个条目是 Template 还是 Integration App：运行 `celigo marketplace list`；只看 Template 用 `celigo marketplace list --type template`；只看 Integration App 用 `celigo marketplace list --type integration-app`。
3. 优先在 Marketplace UI 中浏览和安装：打开 listing 的 preview page；UI 是主要入口。
4. 判断 Template：它是开放、可定制的蓝图，每个 flow、export、import、script 进入账户后都是你可编辑的资源，可重命名、重构或重写；代价是 Template 不接收持续更新，源应用 API 变化时由你修复。
5. 判断 Integration App (IA)：它是厂商维护、结构锁定的产品，核心 flows、mappings、logic 受升级保护，Celigo 或 partner 可在不破坏你的定制的情况下发布更新；你只能配置 IA 暴露的 settings、mappings、endpoints，不能重写核心。
6. 按需求选择：需要持续厂商更新选 Integration App；需要完全控制并自己维护选 Template；不确定时把两者都列出并比较。
7. 注意选错的相反失败模式：需要 IA 却选 Template，你会永久自己维护且没有上游修复；需要 Template 却选 IA，一旦需要超出暴露范围的定制就会碰到 locked-component ceiling。
8. AI Agents 是第三种 listing 类型，可在 marketplace 浏览查看可用项。
9. 区分两种操作：whole-template install 创建全新集成，包含蓝图中每个资源的新副本，意图是“搭建整个集成”。
10. whole-template install 在 Celigo Marketplace UI installer 的 listing preview page 中运行。
11. single-element copy 只把一个元素（flow、export、import、connection 或 script）及其依赖放入已有集成，意图是“借用一个部件”。
12. 从措辞识别意图：说“install the X template”或“set up X from a template”时做 whole install；说“copy the Y flow from the X template”或“I just want the customer export”时做 single-element copy。
13. 资源落地后，被复制的是 flows、exports、imports、scripts、lookup caches、response mappings，它们成为你拥有的新资源，没有回链到蓝图；编辑它们不影响源，编辑源也不影响它们。
14. connections 从不被复制：蓝图的 connection ids 是占位符；install 和 copy 会把每个 connection 解析到真实账户连接，复用匹配（同 type + endpoint shape）或创建新连接；连接是共享资源，复制它们只会重复指向同一 endpoint 的凭据。
15. single-element copy 会拉取完整依赖级联：复制 flow 会带上其 exports、imports、scripts 和 lookup exports，每个又带上其 connection（映射）和 hook scripts，因此得到可运行元素而不是半接线片段。
16. 若 listing 匹配你的源 + 目标且你想要一个快速开始并由自己拥有，安装 Template。
17. 若你想要受支持、自动更新且不需重写核心逻辑的产品，安装 Integration App。
18. 若你只需要一个不适合的蓝图中的一个 flow 或步骤，把该单个元素复制到你的集成。
19. 若没有 listing 匹配，或需求高度定制，从零构建。
20. 预览蓝图再安装：检查蓝图内容和它期望的连接，运行 `celigo templates preview <id> --summary` 和 `celigo templates preview <id> --model Connection`。
21. 安装 whole template 或 Integration App 时，在 Celigo Marketplace UI installer 的 listing preview page 运行安装器；安装器走多步向导：映射或创建 connections、接受 license、选择 plan、配置。
22. 不要依赖程序化 whole-install：简单安装 API `POST /v1/integrations/template/{id}` 带 `connectionMap` body 只对简单单集成模板成功；多数已发布蓝图是多步安装器，会被拒绝；应使用 UI installer。
23. 复制单个元素时，把它复制到已有集成；提前选择目标集成，否则元素会独立落地；复制会拉取该元素的完整依赖级联，并把其 connections 映射到你的账户连接（复用匹配或创建新）。
24. 复制 flow 可能在目标上创建 flow grouping，并通过 Celigo staged-changes review；在 UI 接受 staged change 后 grouping 才可用，然后继续。
25. 资源落地后，验证每个 mapped connection 指向正确的账户连接（参见 configuring-connections）。
26. 在目标集成或 flow grouping 上填充蓝图期望的 settings references，例如 `{{settings.integration.region}}`；未满足的 reference 会阻止 flow 运行。
27. 验证结构，确认 sandbox vs production 匹配你的环境，然后 enable flows。
28. 安装或复制后，所有内容都是普通可编辑资源，可像手建一样编辑、删除或运行；IA 核心组件例外，仍保持锁定。
29. 提交前检查：先运行 `celigo account search`，避免重复已有集成或连接。
30. 提交前检查：选择正确 catalog 类型——Template（你拥有并维护）vs Integration App（厂商维护、锁定）；该选择难以逆转。
31. 提交前检查：已预览蓝图（`celigo templates preview <id> --summary`）并知道它期望哪些 connections。
32. 提交前检查：知道安装将映射到哪些已有 connections，或必须创建新的 connections。
33. 提交前检查：单元素复制已选择目标集成（或接受独立落地）。
34. 提交前检查：sandbox vs production 正确——安装的 flows 和 connections 必须匹配你的环境。
35. 提交前检查：对于会在已有集成上创建新 flow grouping 的复制，准备好到 UI 接受 staged change。
36. Gotcha：whole-template install 在 Marketplace UI 运行；简单安装 API 只处理简单单集成模板，多数发布蓝图是多步安装器并会程序化失败；从 UI preview page 安装。
37. Gotcha：Templates 不接收持续更新；源应用 API 变化时你自己修复；需要厂商维护更新时选 Integration App。
38. Gotcha：Integration Apps 结构锁定；核心 flows、mappings、logic 不能重写，只能配置 IA 暴露项；需要深度定制时不要选 IA。
39. Gotcha：Connections 是映射不是复制；install 和 copy 把占位 connection ids 解析到真实账户连接，复用匹配或创建新；不要产生重复凭据指向同一 endpoint。
40. Gotcha：复制一个元素带来整个依赖闭包；复制 flow 会拖入 exports、imports、scripts、lookups（及其 connections 和 hooks）；你得到的是可运行元素。
41. Gotcha：安装后一切都归你；安装和复制的 flows、exports、imports、scripts 是普通可编辑资源；IA 核心组件是例外，保持锁定。
42. Gotcha：复制 flow 可能通过 staged changes 创建 flow grouping；如果目标集成没有同名 grouping，复制会创建它；在 UI 接受 staged change 后才可用。
43. Gotcha：Settings references 可能不会自动带过来；模板 flow 可引用 integration 或 flow-grouping settings（例如 `{{settings.integration.region}}`）；如果 owning resource 没来，在目标上填充这些 settings 后复制的元素才能运行。
44. Gotcha：Marketplace 访问受计划限制；浏览、预览或安装可能返回 `403 Forbidden`。
45. Gotcha：Lookup cache 数据只在 flagged 时随蓝图传输；仅当 `includeDataInTemplatesAndCloning: true` 时包含数据；否则缓存落地为空。
46. 错误处理：`Install step is invalid: invalid templateZip` 的原因是通过简单安装 API 安装多步模板；修复是从 Marketplace UI 的 listing preview page 安装。
47. 错误处理：`403 Forbidden` on marketplace list/preview/install 的原因是账户或 token 的市场访问受计划限制；修复是使用具有 marketplace 访问的账户/计划，或联系 Celigo admin。
48. 错误处理：已安装 flow 不运行且缺少 setting 的原因是蓝图引用的 integration 或 flow-grouping settings 没带过来；修复是在目标 integration 或 flow grouping 上填充被引用的 `settings.<scope>` 值。
49. 错误处理：复制 flow 的 grouping 对后续调用不可见 的原因是通过 staged changes 创建了新 flow grouping 尚未接受；修复是在 UI 接受 staged change，然后继续复制。
50. 错误处理：安装后出现重复 connection 的原因是创建了新连接而不是映射已有连接；修复是重新映射安装到已有连接——连接应共享，不重复。
51. 错误处理：已安装资源无法编辑 的原因是它是 Integration App 核心组件（升级保护），不是 template 资源；修复是通过 IA 暴露的 settings 和 mappings 定制，或需要完全控制时使用 Template。

适用边界 · 注意事项

• 账户或 token 没有 Celigo Marketplace 访问权限时（浏览、预览或安装会返回 `403 Forbidden`），不要使用本技能。
• 没有 marketplace listing 匹配你的源 + 目标，或需求高度定制时，不要强行套用蓝图，应从零构建。
• 只需要一个 flow、export、import、connection 或 script 时，不要做 whole-template install；应把该单个元素复制到已有集成。