cx-ai-center

AI Center スキル

AI／GenAI アプリケーションに関するあらゆることに対応するツールです — 動作に関する質問（プロンプト／応答、品質、ハルシネーション、ガードレール、セキュリティ、コスト／トークン、エラー、レイテンシ — GenAI スパン／タグを通じて AI アプリが公開するあらゆる情報）と、管理するための操作（アプリケーション、評価／ポリシー、ポリシー↔アプリのリンク、モデル料金）の両方に対応します。リクエストが AI アプリケーションまたはその GenAI テレメトリに関わる場合は、このスキルを使用してください。

Coralogix AI Center は、GenAI／LLM アプリケーションを監視、評価、保護します。このスキルは、次の 2 つのソースから AI アプリに関する質問に回答します。

• 設定（このスキルの cx ai-center コマンド）：AI アプリケーションの一覧、設定済みの評価／ポリシー、カバレッジ、カスタム評価、モデル料金 — これらはいずれもスパンのテレメトリには含まれません。
• テレメトリ（GenAI スパン）：ユーザーが尋ねた内容、モデルの回答、コスト、トークン、レイテンシ、エラー、ツール呼び出し、評価／ガードレールの判定 — cx spans '<DataPrime>' でクエリします。実行可能なクエリライブラリ、スパンのスキーマ、プレイブックの全容については、references/ai-center-queries.md を参照してください。

質問に応じてソースを使い分けてください。「ガードレールが設定されていないアプリはどれか」 → 設定（cx ai-center applications list）、「チャットボットにユーザーは何を尋ねているか」 → テレメトリ（cx spans '…'。GenAI スパンから会話を読み取ります）。両方が必要な質問もあります — たとえば、「チャットボットの PII ポリシーは実際に PII を検出できているか」 では、設定（ポリシーが有効か）とテレメトリ（PII の判定とメッセージ）を組み合わせます。

---

破壊的操作の安全性

すべての書き込み操作（create、update、delete、add、remove、set）には、対話形式での確認が必要です。ai-center はリスクの高いコマンドであるため、書き込み操作は ~/.cx/config.toml の allow_risky_commands によっても制限されます。スクリプトでプロンプトを省略するには、--yes を指定します。

重要：ユーザーから明示的な承認を得ずに、--yes を指定してはいけません。 書き込み操作を実行する前に、次の手順を守ってください。

1. 実行する操作の内容（作成／変更／削除／リンクする対象）をユーザーに正確に説明します。
2. ユーザーが確認するまで待ちます。
3. 確認を得た後にのみ、--yes を付けて実行します。

読み取り操作（list、get、coverage、list-for-application、model-pricing get）には確認は不要で、自由に実行できます。

読み取り専用モード

--read-only（または CX_READ_ONLY=1）を使うと、CLI レベルですべての書き込みをブロックできます — 安全に調査できます。

エージェントモード

AI エージェント（Claude Code、Cursor、Codex、…）内で実行すると、cx はそれを検出します。そして、人間が y/n を入力するまで永久に停止してしまう確認プロンプトを表示する代わりに、ユーザーの承認を得てから --yes を付けて再実行するよう伝えるエラーを即座に返します。

削除コマンドなし（仕様）

CLI では、カスタム評価ポリシー、AI アプリケーション、モデル料金の削除は意図的に提供していません — AI v3 API には削除エンドポイントがありますが、cx ai-center からは利用できません。

• カスタム評価ポリシー： 削除できません。アプリから外すには custom-evaluations remove で関連付けを解除してください（ポリシーオブジェクトは残り、再び関連付けることができます）。
• モデル料金： 削除コマンドはありません。これはアプリごとではなくチーム全体に適用されるため、変更またはクリアするには、新しいマップを指定して model-pricing set を実行します（空のマップ {} を指定すると、すべてのオーバーライドがクリアされます） — set は全体を置き換えます。

---

基本原則

コンテンツに関する質問（品質、ハルシネーション、センチメント、トピック）では、実際の会話を読み取り、traceID を引用してください。判定タグだけに頼ってはいけません。会話記録は 2 種類の形式（gen_ai.input.messages／output.messages、または旧形式のインデックス付きタグ gen_ai.prompt.<n>／completion.<n>）のいずれかで記録されています。両方の形式に対応し、システムプロンプトとツールのやり取りを除外するライブラリ内の**「会話の読み取り（コンテンツに関する質問）」**クエリを使って読み取ってください。詳しくは、references/ai-center-queries.md を参照してください。

---

CLI コマンド

ユーザーには名前を表示し、UUID は内部でのみ使用してください。 結果を提示する際は、生の UUID ではなく、人が読めるアプリ名（アプリケーション／サブシステム）と評価名を使ってください。UUID が必要なのは、by-id コマンドや書き込みコマンドを呼び出すときだけです。一致する list コマンドの結果から自分で UUID を特定してください（推測したり、ユーザーに UUID を貼り付けてもらったりしないでください）。

アプリケーション（一覧とガードレールの状態）

コマンド	目的
cx ai-center applications list	guardrailsIntegrated（ガード済み）の状態を含む AI アプリの一覧
cx ai-center applications list --evaluation-type <TYPE>	評価タイプを使用するアプリに絞り込み（複数指定可）
cx ai-center applications list --page-size <N> --page-offset <N>	ページネーション
cx ai-center applications get <application-id>	UUID でアプリケーションを 1 件取得

評価（アプリに設定されたポリシー）

コマンド	目的
cx ai-center evaluations list	設定済みの評価をすべて表示
cx ai-center evaluations list --application <app> --subsystem <sub>	1 つのアプリ（この組み合わせ）に絞り込み
cx ai-center evaluations list --evaluation-type <TYPE>	タイプで絞り込み — <TYPE> は API の列挙値です（例：PII、TOXICITY、PROMPT_INJECTION。coverage のキー）。小文字形式ではありません
cx ai-center evaluations get <evaluation-id>	UUID で評価を 1 件取得
cx ai-center evaluations create --from-file eval.json	評価を作成／有効化 (書き込み)
cx ai-center evaluations update <evaluation-id> --from-file patch.json	部分更新 (書き込み)
cx ai-center evaluations delete <evaluation-id>	アプリから評価を削除 (書き込み)

カスタム評価（ポリシー）とアプリケーションのリンク

コマンド	目的
cx ai-center custom-evaluations list	カスタム評価ポリシーをすべて表示
cx ai-center custom-evaluations list-for-application <application-id>	1 つのアプリにリンクされたポリシー
cx ai-center custom-evaluations create --from-file policy.json	カスタムポリシーを作成 (書き込み)
cx ai-center custom-evaluations update <id> --from-file patch.json	部分更新 (書き込み)
cx ai-center custom-evaluations add <evaluation-id> <application-id>	ポリシーをアプリに追加 (書き込み)
cx ai-center custom-evaluations remove <evaluation-id> <application-id>	リンクを解除（元に戻せます） (書き込み)

by-id で取得できるのは事前構築済みのものに限られます。 evaluations get <id> は事前構築済み／設定済みの評価を取得します。 カスタムポリシーには get-by-id がありません。custom-evaluations list／ list-for-application で探し、id／名前で照合してください。

カバレッジとモデルの料金

コマンド	目的
cx ai-center coverage	評価タイプごとに、それを使用するアプリの数を示すマップ（カバレッジ／ギャップ分析）
cx ai-center model-pricing get	チームのカスタムモデル別料金オーバーライド
cx ai-center model-pricing set --from-file prices.json	チームの料金を設定（チーム全体に適用。新しいデータのみ） (書き込み)

evaluations と custom-evaluations の --from-file の本文は、AI v3 API の形式と完全に一致します。標準入力から JSON を読み込むには - を使用してください。evaluations create では target が必須で、大文字（PROMPT または RESPONSE）で指定する必要があります。custom-evaluations create では name、instructions、policyType が必須です。例外： model-pricing set が受け取るのは、生の model→price マップのみです。cx がこれを {"prices": …} としてラップするため、外側の prices エンベロープは含めないでください。各モデルには価格オブジェクトを対応付けます。4 つのフィールドはすべて任意の double（トークン100 万個あたりの USD）です。該当しないフィールドは省略してください。

{
  "gpt-4o": {
    "inputPricePerMillionTokens": 2.5,
    "outputPricePerMillionTokens": 10,
    "cacheReadPricePerMillionTokens": 1.25,
    "cacheWritePricePerMillionTokens": 3.75
  }
}

空のマップ {} を指定すると、すべてのオーバーライドがクリアされます（set はセット全体を置き換えます。チーム全体に適用され、新しいデータのみが対象です）。 model-pricing get はラッパー { "pricing": { "id", "companyId", "prices": { … } } } を返します。モデルごとのオーバーライドは prices の下にあり、設定がない場合は空です。

---

よくあるワークフロー

一覧の確認とガードレールの不足状況

# Which apps are NOT guarded?
cx ai-center applications list -o json | jq '[.[] | select(.guardrailsIntegrated==false)]'

アプリでポリシーを有効にする（書き込み — 先に確認してください！）

# 1. Describe to the user; 2. get approval; 3. then:
cx ai-center evaluations create --from-file eval.json --yes
# eval.json: { "application": "...", "subsystem": "...", "target": "PROMPT", "config": { "<type>": {...} }, "isEnabled": true }
# `target` is REQUIRED and must be UPPERCASE — "PROMPT" or "RESPONSE" (the API rejects lowercase / a missing target).

実際の会話を読む（設定ではなくテレメトリ）

references/ai-center-queries.md のクエリライブラリを使って cx spans を実行します。メッセージ、コスト、レイテンシ、エラー、ツール呼び出し、ユーザーごとの分析を確認できます。

---

主な原則

• 設定とテレメトリの区別： インベントリ／評価／ポリシー／カバレッジ／料金 → cx ai-center、 コンテンツ／コスト／レイテンシ／エラー／判定 → cx spans 経由の GenAI スパン。一方の情報から他方について回答しないでください。
• 書き込みの前に確認してください。 操作内容を説明し、承認を得てから --yes を指定して実行します。

---

関連スキル

• cx-telemetry-querying — ログ／スパン／メトリクス／DataPrime の一般的なクエリ（このドキュメントで使う cx spans クエリの基盤です）。
• cx-olly — 会話型 AI アシスタント（cx olly ask）。