cekura-create-agent

Cekura エージェントの作成

メインエージェントのセットアップ全体のフローです。最初にプロバイダーを選択してください。以降のすべての内容がこれによって決まります。

LiveKit / Pipecat に関する注意： Cekura への接続方法（電話、WebRTC、チャット）にかかわらず、provider.type = livekit または pipecat を維持してください。電話番号があるという理由だけで、LiveKit / Pipecat のエージェントを self_hosted に変更しないでください。これらのプロバイダーは、それぞれのタイプのまま、電話ベースのシミュレーションと SDK 統合をネイティブにサポートしています。

Standard path (KoreAI, Genesys, Cisco, self-hosted):
Phase 1  → Phase 2  → Phase 3  → Phase 4  → Phase 5  → Phase 6  → Phase 7  → Phase 8  → Phase 9  → Phase 10 → Phase 11
Project    Provider   Basics &   Description  Create     SDK        Mock       KB         Dyn Vars   Advanced   Verify
                      Conn Type               agent     (no-op)     Tools

LiveKit / Pipecat path (Phase 6 wires the Cekura SDK in the user's repo):
Phase 1  → Phase 2  → Phase 3  → Phase 4  → Phase 5  → Phase 6  → Phase 7  → Phase 8  → Phase 9  → Phase 10 → Phase 11
                                                       SDK
                                                       integration

Auto-import path (VAPI / Retell / ElevenLabs / Bland / Synthflow — configure_from_provider: true):
Phase 1  → Phase 2  → Phase 5  → Phase 10 → Phase 11
Project    Provider   Create     Advanced   Verify
           (api_key   (import,   config
           + agent_id) poll
                      progress)

11 のフェーズ

フェーズ	ファイル	内容	標準プロバイダー	LiveKit / Pipecat	自動インポート（VAPI/Retell/ElevenLabs/Bland/Synthflow）
1	phase1-project.md	プロジェクトを一覧表示し、project_id を選択	✓ 必須	✓ 必須	✓ 必須
2	phase2-provider.md	プロバイダーを選択し、すべての認証情報を事前に収集	✓ 必須	✓ 必須	✓ 必須（api_key + agent_id のみ）
3	phase3-basics.md	メインエージェントの名前、言語、接続モード（LiveKit / Pipecat では複数選択）	✓ 必須	✓ 必須	スキップ — 自動インポート
4	phase4-description.md	メインエージェントの説明（完全なシステムプロンプト）を収集	✓ 必須	✓ 必須	スキップ — 自動インポート
5	phase5-create.md	メインエージェントを作成 — POST v2、プロバイダーごとの完全な例	✓ 必須	✓ 必須	✓ 必須（自動インポート経路）
6	phase6-sdk-integration.md	ユーザーのリポジトリで SDK を統合（LiveKit / Pipecat のみ）	何もしない	✓ 必須（明示的に拒否された場合を除く）	何もしない
7	phase7-mock-tools.md	メインエージェントのモックツール — 自動取得（マネージドプロバイダーまたはセルフホストの MCP）または手動	✓ 必須	✓ 必須	スキップ — 自動インポート
8	phase8-knowledge-base.md	メインエージェントのナレッジベース — KB ファイルをアップロード	✓ 必須	✓ 必須	スキップ — 自動インポート
9	phase9-dynamic-variables.md	メインエージェントの動的変数 — API 経由で登録	✓ 必須	✓ 必須	スキップ — 自動インポート
10	phase10-advanced.md	自動同期、自動インポート通話、発信設定	✓ 必須	✓ 必須	✓ 必須
11	phase11-verify.md	メインエージェントのセットアップを確認 — チェックリスト + 概要 + 次のスキルへの引き継ぎ	✓ 必須	✓ 必須	✓ 必須

---

このスキルでできること

このスキルは、ユーザーのメインエージェント（テスト対象となる既存の音声／チャット AI）を Cekura 上に設定し、テストできるようにします。このスキル内で「エージェント」とは常に、ユーザーが本番環境で使用している音声／チャット AI（テスト対象）を指し、新たに作成するエージェントを指すものではありません。フェーズ 4 までに、メインエージェントのアイデンティティ、説明、目的を完全に確立する必要があります。フェーズ 4 以降に「このエージェントには何をさせますか？」と尋ねてはいけません。ユーザーの既存コード、プロバイダー設定、またはシステムプロンプトからすでに判断されています。

---

実行モデル — まずお読みください

このスキルは一度に 1 フェーズずつ、順番に実行します。先の計画を立てたり、複数のフェーズをまとめて実行したり、順番を飛ばしたりしないでください。

各フェーズの実行方法：

1. 開始するフェーズを告知します：「フェーズ N — [名前] を開始します」
2. フェーズファイルを読みます — phaseN-*.md を開き、指示に従ってください。フェーズの内容に関する記憶に頼らないでください。
3. そのフェーズのファイルに記載されたすべてのタスクを完了します
4. ゲート条件を満たします
5. 完了を告知します：「フェーズ N が完了しました」
6. すぐにフェーズ N+1 に進みます。ユーザーからの指示を待たないでください 絶対に次のことをしないでください：

• フェーズ 3 が完全に完了する前にフェーズ 4 を開始する
• 自動インポートに対応していないプロバイダーについて、「もう完了しているようだから」とフェーズを飛ばす
• メインエージェントを作成しただけで、フェーズ 5 の後に終了する
• 各フェーズを完了させずに、複数のフェーズを 1 つの回答にまとめる
• 自動インポートに対応していないプロバイダーのフェーズを飛ばす（例：LiveKit で「フェーズ 7～10 は不要」など）。このようなプロバイダーでは、すべてのフェーズが必須です
• フェーズファイルを先に読まずに、そのフェーズについて判断する
• フェーズの間に「続けてもよろしいですか？」とユーザーに尋ねる。止まらずに続ける
• 手作業で行う手順をユーザーに提示する。Bash と API 呼び出しを使って、自分で実行する
• 仮の URL や「後で実際のサーバーに接続する」という選択肢を提示する。WebSocket URL が必要な場合は、今すぐ自分でサーバーを起動して ngrok を実行し、実際に動作する URL を取得する

自分で実行してください。指示するのではありません。 何かを行う必要がある場合（API 呼び出し、フィールドの更新、シナリオの実行など）は、利用可能なツールを使って直接実行してください。ユーザーが実行する手順を書き出してはいけません。ユーザーの入力がなければ本当に先に進めない場合（ユーザーにアップロードしてもらうファイルや、ユーザー自身しか決められないことなど）に限り、ユーザーに尋ねてください。

生の API 呼び出しではなく、MCP ツールを使用してください。 Cekura MCP サーバーは設定済みで、認証されています。プロジェクトの一覧表示、エージェントの作成、変数の登録、シナリオの実行、結果の取得など、Cekura プラットフォームのすべての操作には、直接 MCP を使用してください。MCP サーバーで実行できる操作について、curl コマンドを生成してはいけません。特定の操作を MCP で実行できない場合に限り、生の curl を代替手段として使用してください。

自動インポートに対応していないプロバイダーでは、例外なく毎回、11 フェーズすべてが必須です。 フェーズ 6（SDK 統合）は LiveKit／Pipecat 以外のプロバイダーでは何も行わないため、その旨を伝えて続行してください。configure_from_provider を使用する VAPI、Retell、ElevenLabs、Bland、Synthflow では、フェーズ 3、4、6、7、8、9 はスキップします（バックエンドがこれらをすべて自動でインポートします）。これらのフェーズファイルには明示的なスキップ指示が記載されているので、それに従ってください。

フェーズ 11 の検証実行が成功するまで、このスキルを終了してはいけません。 実行で問題（動的変数の欠落、モックツールの不具合、誤った接続設定、エージェントが無反応など）が判明した場合は、該当するフェーズに戻って問題を修正し、実行を再試行してください。トランスクリプトで実際の会話を確認する前に、絶対に終了してはいけません。

ユーザーがセットアップを一部完了している場合： 最初に、どのフェーズが完了しているかを尋ねて、完了済みとして記録してください。その後、最初の未完了フェーズから開始します。ただし、必ずフェーズ 11 まで完了してください。

会話形式で確認してください。質問は一度に 1 つにしてください。 すべての質問を一度に提示してはいけません。

正しい値を特定せずに、フィールドのデフォルト値を使用してはいけません。 デフォルト値が設定されているフィールドについてはすべて、コード、設定、プロバイダー API、またはコンテキストから適切な値を積極的に特定し、その後ユーザーに確認してください。本当に特定できない場合に限り、ユーザーに直接尋ねてください。簡単だからという理由でフィールドをデフォルトのままにしてはいけません。デフォルト値は最後の手段であり、出発点ではありません。

推測に基づいて判断した後は、必ず説明して確認してください。 コード、設定、またはコンテキストから値を特定した場合は、決定した内容とその理由を 1 行で伝え、使用前にユーザーへ確認してください。例：「言語を multi に設定します。システムプロンプトに、ヒンディー語と英語の両方に固有の指示が含まれているためです。この設定でよろしいですか？」判断を黙って確定してはいけません。

---

API アクセス

前提条件： Cekura アカウントと API キーまたは OAuth。

Claude Code プラグインのユーザーは、プラットフォームツールが自動で設定されます。プラットフォーム操作が機能しない場合は、/setup-mcp を実行して接続を設定してください。

その他のクライアントでは、Cekura ダッシュボードを使用するか、API を直接呼び出してください。Cekura API のすべての呼び出しでは、認証ヘッダーとして X-CEKURA-API-KEY: <key> を使用してください。 Authorization: Api-Key や Authorization: Bearer は絶対に使用しないでください。

---

参照ファイル

• references/integrations.md — プロバイダーごとの全フィールド一覧、WebSocket メッセージ形式、カスタム Webhook ペイロード、プロバイダー比較表
• references/livekit-tracing.md — LiveKit SDK の統合パターン（Python と JS/TS）、インストールするバージョン、track_session と observe_session の違い、環境変数、よくある落とし穴
• references/pipecat-tracing.md — Pipecat SDK の統合パターン、シングルステップ API とマルチステップ API、必要なアグリゲーター、OTel トレーシング、遅延アップロード
• references/websocket-server-scaffold.md — Cekura のプロトコルを実装する WebSocket サーバーのコードひな形（Python、Node.js/TS、FastAPI）。ユーザーがサーバーの生成を必要としている場合に使用します
• references/mock-tool-design.md — 入力ごとの分岐例、チェーン依存関係の設計、追加して置き換えないパターン
• references/api-reference.md — メインエージェント API エンドポイントの完全な一覧、すべてのフィールドスキーマ、モックツールと KB のエンドポイント
• scripts/upload-agent.sh — 長いシステムプロンプトを使ってエージェントを作成／更新するための Curl ラッパー

ドキュメント： https://docs.cekura.ai/documentation/integrations/ | https://docs.cekura.ai/mcp/overview