cx-olly

Olly Observability Agent スキル

このスキルでは、cx olly CLI コマンドを使用して、Coralogix の Observability Agent（Olly）を操作します。Olly はオブザーバビリティデータを分析し、アラート、メトリクス、ログに関する質問に回答したり、チャートやレポートなどのアーティファクトを生成したりできます。

cx olly ask の --agent-to-agent-mode のデフォルト値は false です。LLM／エージェントの場合は、--agent-to-agent-mode を指定してください。詳しくは、以下の「エージェント間モード」を参照してください。

CLI コマンド

コマンド	目的	主なフラグ
cx olly ask "message"	Observability Agent にメッセージを送信する	--chat-id、--model、--timeout、--agent-to-agent-mode
cx olly artifacts list	生成されたすべてのアーティファクトを一覧表示する	-
cx olly artifacts get <id>	ID でアーティファクトの内容を取得する	-

出力形式： 機械可読な出力にするには、-o json または -o toon を追加します。

単一プロファイルのみ： cx olly コマンドは、複数プロファイルへの一括実行をサポートしていません。-p <profile> を指定して、単一のプロファイルを指定してください。

Olly の実行（デフォルトでは非同期）

cx olly ask はデフォルトで非同期に実行してください： ブロックして待つのではなく、バックグラウンドプロセスとして起動し、完了するまでポーリングしてください。Olly の調査には通常数分かかるため、cx olly ask ではこれが標準的な実行方法です。

Olly がすぐに回答すると予想される短い質問（簡単な情報の照会や一行の追加質問など）の場合に限り、cx olly ask をインライン（フォアグラウンドでブロック）実行してください。迷った場合は、バックグラウンドで実行してください。

チャットコマンド

新しい会話を開始する

cx olly ask "What alerts fired today?" --agent-to-agent-mode

新しいチャットが作成され、応答と、追加の質問に使用できる Chat ID が返されます。 共有するコンテキスト（ソースファイルへのクイックアクセスなど）がない場合や、作成したチャットを人間のみが使用する場合は、--agent-to-agent-mode を削除してください。

既存のチャットを続ける

cx olly ask "Tell me more about the error rates" --chat-id <chat-id> --agent-to-agent-mode

--chat-id を使用すると、会話を続け、以前のメッセージのコンテキストを維持できます。追加の調査が始まる場合は、追加の質問もバックグラウンドで実行してください。

モデルの選択

利用可能なモデルには、gpt-5.2（デフォルト）、claude-sonnet-4-5、sonnet-4.6、gpt-5.4、claude-haiku-4-5 があります。

cx olly ask "Explain this error" --model claude-sonnet-4-5 --agent-to-agent-mode

タイムアウト

時間がかかる可能性のある複雑なクエリでは、Olly の応答タイムアウト（デフォルト：900 秒）を延長します。

cx olly ask "Deep analysis of last week's incidents" --timeout 1800 --agent-to-agent-mode

--http-timeout <SECONDS>（または CX_HTTP_TIMEOUT）は、Olly を含むすべての CLI コマンドにおける HTTP リクエストの期限を設定します。これは Olly の応答タイムアウトとは別です。

エージェント間モード

cx olly ask は人間にもエージェントにも直接使用されるため、--agent-to-agent-mode のデフォルト値は false です。LLM／エージェントの場合は、--agent-to-agent-mode を指定して、短くサブエージェント形式の応答を利用してください。チャートや表は表示せず、推測する代わりに確認の質問をし、より広いコンテキストを活用します。

cx olly ask "Analyze this for me" --agent-to-agent-mode

この設定はチャットごとではなく、呼び出しごとに適用されます。 --chat-id には保存されないため、後続の各ターンでも --agent-to-agent-mode を再度指定してください。指定しないと、会話の途中でモードが人間向けに戻ります。

アーティファクト

Olly は、クエリ結果、プレビュー、引用などのアーティファクトを生成できます。アーティファクト ID は、エージェントの応答テキスト内にリンクとして表示されます。

すべてのアーティファクトを一覧表示する

cx olly artifacts list
cx olly artifacts list -o json

アーティファクトの内容を取得する

cx olly artifacts get <artifact-id>
cx olly artifacts get <artifact-id> -o json

artifacts get コマンドは、以下を自動的に実行します。

1. アーティファクトのメタデータを取得します
2. 署名付き URL から内容をダウンロードします
3. gzip コンテンツを展開します
4. JSON を解析し、大きなコンテンツにはスピルロジックを使用します
5. JSON 以外のテキストを一時ファイルに保存します

出力の動作：

• JSON コンテンツ： 直接表示するか、大きい場合はファイルにスピルします
• テキストコンテンツ： 一時ファイルに保存します（例：/tmp/cx_results_artifact_<id>_<hash>.txt）

ワークフローの例

問題を調査する

# Start investigation — run in the background and poll for completion
cx olly ask "Why is the checkout service showing high latency? Check logs with 'checkout:' strings and aws related metrics" --agent-to-agent-mode

# Follow up with the chat ID from the response — also background and poll
cx olly ask "What changed in the last hour?" --chat-id abc-123-def --agent-to-agent-mode

# Once the interaction has completed, get any generated charts
cx olly artifacts list -o json | jq '.[0].id'
cx olly artifacts get <artifact-id>

スクリプト用に JSON 出力を取得する

# Get response as JSON
cx olly ask "List top 5 error messages" -o json --agent-to-agent-mode | jq '.response'

# Parse artifacts
cx olly artifacts list -o json | jq '.[] | {id, filename, created_at}'

特定のモデルで詳細に分析する

cx olly ask "Perform root cause analysis for the outage on 2024-01-15" \
  --model claude-sonnet-4-5 \
  --timeout 1800 \
  --agent-to-agent-mode

主な原則

• デフォルトで非同期 - cx olly ask をバックグラウンドプロセスとして実行し、完了するまでポーリングします。Olly がすぐに回答できると予想される短い質問に限り、インライン（ブロッキング）で実行してください
• チャット ID でコンテキストを維持 - 会話を続けるには、応答に含まれるチャット ID を保存します
• スクリプトでは -o json を使用 - jq にパイプして、フィルタリングや抽出を行います
• アーティファクト ID は応答テキスト内にあります - [Chart](https://...artifact_view/<id>) のような Markdown リンクを探します
• 単一プロファイルのみ - cx olly は複数プロファイルへのクエリをサポートしていません
• 大きなアーティファクトは自動的に一時ファイルに保存 - 設定された制限を超える JSON コンテンツは、一時ファイルに保存されます
• 質問する前にソースコードを確認 - 調査を始める指標など、入手できる場合はソースコードから具体的なコンテキストを Olly に提供してから呼び出します
• 調査範囲を限定 - ログのみ、または特定の時間範囲に限定するなど、適切な範囲を Olly に指定します
• LLM／エージェントとして呼び出す場合は --agent-to-agent-mode を渡す - デフォルトは false（人間向け）です。エージェントは、短いサブエージェント形式の応答を得るため、このモードを有効にしてください

関連スキル

• cx-telemetry-querying - AI エージェントの支援なしで DataPrime／PromQL を直接クエリするためのスキルです（ログ、スパン、メトリクス、RUM を対象とします）
• cx-alerts - アラート定義を管理するためのスキルです