cekura-onboarding

Cekura 平台引导

引导新用户从创建账户到获得首个已验证结果——完成一次测试通话并查看转录内容（测试），或获得一次经过评分的生产通话（可观测性）。

核心原则

引导流程应尽量精简，但只有验证工作流成功运行后才能结束——绝不能止步于“已创建记录”。

• 精简：每个提供商只需完成一个高价值连接步骤；其他所有事项（SDK、模拟工具、知识库、动态变量、自定义指标）都推迟到获得首个结果之后。
• 验证：当 Agent／场景记录存在时，引导流程还未完成。只有完成一次测试通话并能查看其转录内容（测试），或导入并评分一条通话日志（可观测性），流程才算完成。配置错误的 SIP 端点或不受支持的电话号码必须在引导过程中发现，而不是几天后才发现。

两种路径

两条路径共用阶段 0 和阶段 2（选择路径、连接 Agent），之后分流。首要目标始终是连接 Agent——没有单独的账户／项目阶段：可用的工具即可证明身份验证有效；若缺少项目，则在进入阶段 2 时顺带处理（projects_list／projects_create）。

• 测试（默认）——生成评估器，在模拟环境中针对 Agent 运行评估，然后查看结果。
• 可观测性——导入生产通话日志，关联指标，进行评估，然后查看结果。

执行方式——请先阅读

此技能每次按顺序执行一个阶段。对于每个阶段：

1. 用通俗的话说明当前步骤（例如：“我们来连接你的 Agent”）——阶段编号仅用于内部导航，绝不能向用户提及。
2. 阅读阶段文件（此技能目录中的 phaseN-*.md）。不要依赖对文件内容的记忆。
3. 完成文件中的所有任务，并满足其门槛条件。
4. 用通俗的话确认当前步骤已完成，然后继续下一步，不要等待用户回复（不要说“阶段 N 已完成”）。

只有在收集缺失信息或解决确实存在的歧义时，才提问（提供商选择、凭证、电话号码、可自托管确认）。不要暂停并再次确认流程已经明确要求的操作——用户启动引导流程，就表示请求创建 Agent、启用指标、生成评估器并开始首次验证运行。（用户客户端自身的工具权限提示仍照常适用。）不要问“准备好继续了吗？”，不要问“要我创建吗？”，也不要问“要我继续吗？”——直接执行步骤并说明进度。唯一例外：门槛受阻时（例如测试路径的描述门槛），应说明阻碍并提供选项。

**引导流程独立完整。**在引导过程中，切勿打开同级的 cekura-create-agent 技能（或任何其他技能）——所需内容（凭证矩阵、描述质量标准）已包含在此技能的阶段文件中。cekura-create-agent 的阶段顺序涵盖引导后的工作（SDK 集成、模拟工具、知识库）；在引导过程中途运行它会将流程带入这些步骤；它仅用于阶段 6 的交接。

各阶段

阶段	文件	操作内容	路径
0	phase0-path.md	选择测试或可观测性；调用一次 aiagents_list 检测是否已有工作	shared
2	phase2-agent.md	创建/连接 Agent——优先选择提供商、保持精简并进行验证	shared
3T	phase3-testing-metrics.md	验证默认指标（创建项目时自动启用）	testing
4T	phase4-testing-evaluators.md	生成首批评估器（优先生成）	testing
5T	phase5-testing-first-run.md	首次测试运行 + 验证关卡	testing
6T	phase6-testing-next.md	后续步骤（SDK、模拟工具、自定义指标）	testing
3O	phase3-observability-ingest.md	导入调用日志 + 验证关卡	observability
4O	phase4-observability-metrics.md	配置入门指标	observability
5O	phase5-observability-evaluate.md	运行指标评估	observability
6O	phase6-observability-review.md	查看结果和后续步骤	observability

（没有阶段 1——旧的账户/项目阶段已停用；客户端/OAuth 设置作为备用方案保留在 references/client-setup.md 中，阶段编号保持不变。）

执行平台操作

优先使用平台工具，而不是描述 API 调用或仪表板操作步骤——直接调用工具。如果调用失败，请解决原因或询问缺少的输入，然后重试；在调用成功之前，切勿声称某个步骤已完成。

切勿编造 ID

每个 Agent ID、场景 ID、调用日志 ID、指标 ID 和运行 ID 都必须来自真实的工具响应。如果没有 ID，请调用相关的列表/检索工具。提供商端的标识符（VAPI assistant ID、API 密钥、webhook URL）由用户提供——切勿猜测。

文档

• 公共文档：https://docs.cekura.ai
• 适用于大模型的文档：https://docs.cekura.ai/llms.txt
• 集成：https://docs.cekura.ai/documentation/integrations/
• references/api-quickstart.md — 入门过程中使用的重要端点。