cekura-onboarding

Cekura プラットフォームのオンボーディング

新規ユーザーを、アカウント作成から最初の検証済み結果まで案内します。つまり、文字起こしを表示できるテスト通話の完了（テスト）か、スコアリング済みの本番通話（オブザーバビリティ）まで進めます。

重要な原則

オンボーディングは最小限にとどめますが、「レコードが作成された」だけで終えてはなりません。検証済みの動作ループまで完了させます。

• 最小限：プロバイダーごとに、効果の高い接続手順を1つだけ行います。それ以外（SDK、モックツール、KB、動的変数、カスタム指標）は最初の結果が得られた後に回します。
• 検証済み：エージェントやシナリオの行が存在するだけでは、オンボーディングは完了していません。テスト通話が1件完了し、文字起こしが表示された時点（テスト）、または通話ログが1件取り込まれ、スコアリングされた時点（オブザーバビリティ）で完了です。設定ミスのあるSIPエンドポイントや未対応の電話番号は、数日後ではなく、オンボーディング中に検出できなければなりません。

2つの進め方

どちらの進め方もフェーズ0と2（進め方の選択、エージェントの接続）は共通で、その後に分岐します。最初の目標は常にエージェントの接続です。アカウントやプロジェクトを個別に準備するフェーズはありません。使用可能なツールで認証を確認し、プロジェクトが存在しない場合はフェーズ2に進む途中で処理します（projects_list／projects_create）。

• テスト（デフォルト） — 評価器を生成し、シミュレーションでエージェントに対して実行して、結果を確認します。
• オブザーバビリティ — 本番通話ログを取り込み、指標を追加して評価し、確認します。

実行モデル — 最初にお読みください

このスキルでは、フェーズを順番に1つずつ実行します。各フェーズで次の手順を行います。

1. わかりやすい言葉で手順を伝えます（例：「エージェントを接続しましょう」）。フェーズ番号は内部での案内にのみ使用し、ユーザーには伝えません。
2. フェーズファイル（このスキルディレクトリ内のphaseN-*.md）を読みます。内容を記憶に頼って進めてはいけません。
3. ファイル内のタスクをすべて完了し、ゲート条件を満たします。
4. わかりやすい言葉で手順の完了を伝え、ユーザーを待たずに次へ進みます（「フェーズNが完了しました」とは言いません）。

質問するのは、不足している情報を集める場合、または本当に曖昧な点を解決する場合のみです（プロバイダーの選択、認証情報、電話番号、セルフホストの確認など）。フローで必要とされる操作をあらためて確認するために、進行を止めてはいけません。ユーザーがオンボーディングを開始した時点で、エージェントの作成、指標の有効化、評価器の生成、最初の検証実行の開始を依頼しています（クライアント側の通常のツール権限プロンプトには従ってください）。「続けてもよいですか？」「作成しましょうか？」「先に進めますか？」などとは尋ねず、そのまま手順を実行して説明してください。例外は、ゲートがブロックされている場合（テストパスの説明ゲートなど）のみです。その場合は、ブロッカーと選択肢を提示してください。

オンボーディングは単独で完結します。 オンボーディング中に、同階層のcekura-create-agentスキル（または他のスキル）を開いてはいけません。必要な情報（認証情報の一覧、説明の品質基準）はすべて、このスキルのフェーズファイルに含まれています。cekura-create-agentのフェーズ順序は、オンボーディング後の作業（SDK統合、モックツール、ナレッジベース）を対象としています。オンボーディング中に実行すると、その作業へフローを乗っ取られてしまいます。このスキルへの引き継ぎはフェーズ6のみです。

フェーズ

フェーズ	ファイル	内容	パス
0	phase0-path.md	テストとオブザーバビリティのどちらかを選択します。既存の作業を検出するために aiagents_list を1回呼び出します	shared
2	phase2-agent.md	エージェントを作成／接続します — プロバイダーを優先し、最小限の構成で検証します	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を捏造しない

エージェント ID、シナリオ ID、呼び出しログ ID、メトリクス ID、実行 ID はすべて、実際のツール応答から取得してください。IDがない場合は、該当する一覧取得ツールまたは取得ツールを呼び出してください。プロバイダー側の識別子（VAPI アシスタント ID、API キー、Webhook URL）はユーザーから取得してください。決して推測してはいけません。

ドキュメント

• 公開ドキュメント：https://docs.cekura.ai
• LLM 向けドキュメント：https://docs.cekura.ai/llms.txt
• インテグレーション：https://docs.cekura.ai/documentation/integrations/
• references/api-quickstart.md — オンボーディングで使用する必須エンドポイント。