> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# AgentEye CLI エージェントスキル

> AgentEye CLI エージェントスキルのドキュメント。

**AgentEye CLI スキル**（`agenteye-cli`）は、インストール可能な *エージェントスキル* です。Claude Code、Codex、および互換ツールなどのコーディングエージェントに、[`agenteye` CLI](/ja/agenteye/cli) を通じて自然言語のリクエスト（*「今日、何か壊れているものはある？」*、*「イベントのプッシュのみ可能なキーを CI に発行して」*、*「発火中のインシデントを確認して自分にアサインして」*）から AgentEye を操作する方法を教えます。

これはサービスでも独立したバイナリでもありません。すでにインストール済みの CLI の上で動作する、小さな命令バンドルです。エージェントは `agenteye --json …` をシェルアウトして実行し、返ってきたクリーンな JSON を解析して、結果を自然な文章で回答します。エージェントができることは、あなたが同じコマンドを手入力することで全て実現できます。

***

## 他の AgentEye インターフェースとの関係

AgentEye では、同じデータと操作にアクセスする方法が 4 つあります。それぞれ補完的な役割を持っています：

| インターフェース                                         | 概要                           | 動作場所                    | 使い所                           |
| ------------------------------------------------ | ---------------------------- | ----------------------- | ----------------------------- |
| **[CLI](/ja/agenteye/cli)**                      | `agenteye` のコマンド・フラグリファレンス   | ターミナル                   | 特定のコマンドを実行またはスクリプト化したいとき      |
| **[CLI レシピ](/ja/agenteye/cli-recipes)**          | コピー＆ペーストで使える `jq`・パイプラインパターン | ターミナル／スクリプト             | CLI を自動化に組み込むとき               |
| **CLI スキル**（このドキュメント）                            | CLI への自然言語フロントエンド            | ワークステーション上のコーディングエージェント | 質問するだけでエージェントに適切なコマンドを選ばせたいとき |
| **[ダッシュボード内 AI アシスタント](/ja/agenteye/assistant)** | ダッシュボードに組み込まれたチャット           | クラスター内の内部 `agent` コンテナ  | ダッシュボード上でデータに関する Q\&A をしたいとき  |

### ダッシュボード内 AI アシスタントとの違い — 重要な区別

これらは影響範囲が大きく異なる、2 つの別々のツールです：

* **ダッシュボード内 AI アシスタント**（[assistant.md](/ja/agenteye/assistant)）は、内部 `agent` コンテナをバックエンドとして持つ、ダッシュボードに組み込まれたチャットです。**読み取り専用＋承認ゲート付きの編集**が可能で、保存済みクエリやダッシュボードの下書きを作成できますが、すべての書き込み操作はあなたの明示的なクリック承認が必要であり、削除操作は行いません。`agent:use` 権限によってアクセスが制限され、閲覧中の組織のデータのみにアクセスできます。
* **CLI スキル**は *あなたの* ワークステーション上で *あなたの* コーディングエージェント内で動作し、**あなた自身として** `agenteye` CLI を操作します。API キーの作成・ローテーション・無効化、組織設定の変更、インシデントの解決、保存済みクエリの削除など、**ミューテーションを含む CLI のフルサーフェス**を実行できます。実行可能な操作はあなたの CLI ログインの権限にのみ制限されます。手動でコマンドを実行する場合と全く同じ慎重さで扱ってください。

***

## 前提条件

1. **`agenteye` CLI がインストール済み**で `PATH` が通っていること（[cli.md](/ja/agenteye/cli) を参照 — `pipx install agenteye`）。
2. **ダッシュボード URL** が設定済みであること（`AGENTEYE_DASHBOARD_URL`、またはエージェントが `--base-url` を渡す）。
3. **ログイン済みのセッション**があること：事前に自分で `agenteye login` を実行してください。スキルはメールで送られるワンタイムコードによるログインを代行**できません** — セッションが存在しないか期限切れの場合（CLI 終了コード `4`）、`agenteye login` を実行するよう案内します。

***

## スキルのインストール

エージェントスキルは `SKILL.md`（とオプションの参照ファイル）を含むフォルダーです。`agenteye-cli` スキルは、エージェントがスキルを探す場所にフォルダーを配置することでインストールします：

* **Claude Code** — `agenteye-cli/` フォルダーを `~/.claude/skills/`（全プロジェクトで利用可能）または `<リポジトリ>/.claude/skills/`（そのリポジトリに限定）にコピーします。Claude Code は自動的に検出します。`/skills` リストで確認するか、説明に合致する質問を直接してみてください。
* **Codex (OpenAI)** — Codex は同じ `SKILL.md` を読み込みます。同梱の `agents/openai.yaml` は `allow_implicit_invocation: true` を設定しているため、タスクが合致した場合は Codex が自動的にスキルを選択します。それ以外の場合は `$agenteye-cli` として明示的に呼び出せます。

このスキルは `agenteye` CLI と一緒にメンテナンスされ、AgentEye パッケージの一部として配布されています。`agenteye-cli` フォルダーが見当たらない場合は、AgentEye の担当者にお問い合わせください。Docker イメージも追加の認証情報も不要です。あなた自身のダッシュボードに対して **公開** の `agenteye` CLI を操作するだけです。

***

## 安全性 — エージェントが CLI を実行する際、ミューテーションは確認プロンプトを表示しません

**エージェントに変更を加えさせる前に必ずお読みください。**

`agenteye` CLI は通常、破壊的な操作の前に *「本当によろしいですか？」* と確認を求めます。しかし、**ターミナルに接続されていない場合は確認を自動スキップします — これはコーディングエージェントの実行方式そのものであり、`--json` も同様にスキップします。** そのため、エージェントに対して安全確認プロンプトは**表示されません**。

スキルはこれを補うように設計されています：実行するコマンドを明示的に提示し、状態変更の前にあなたの明示的な **OK** を求めるよう指示されています。この規律を守ってください — エージェントを通じて AgentEye を操作する際、*あなた自身* が確認ステップです。注意すべき状態変更コマンドは以下の通りです：

* `keys create` / `update` / `disable` / `regenerate`
* `users create` / `update` / `disable` / `enable`
* `settings set`
* `alerts create` / `update` / `delete` / `test`
* 書き込み系 `incidents` サブコマンド：`ack` / `assign` / `resolve` / `open` / `comment-add` / `comment-delete` / `subscribe` / `unsubscribe`
* `query create` / `update` / `delete`
* `agent rename` / `delete`
* `orgs switch`

**Observe** 配下（`events`、`sessions`、`evals`、`errors`、`list`、`whoami`、`orgs list/current/perms`）はすべて読み取り専用で、何も変更しません。

エージェントは **あなた自身** として動作するため、あなたのログインが許可している操作のみ実行できます。権限は**組織ごと**に解決されます（[api-keys.md](/ja/agenteye/api-keys) を参照）。権限がないコマンドは終了コード `5` と共に該当する権限名を返すため、エージェントは失敗の理由を不明瞭にせず、管理者に何を依頼すべきかを正確に伝えることができます。

***

## 質問できること

スキルは自然言語の意図を適切な `agenteye` コマンドにマッピングします。推測を避けるために、まず有効な値を確認します（`list <kind>`、`whoami`）：

* *「過去 24 時間に壊れている／失敗しているものはある？」* → `errors --since 24h --aggregate` を実行し、内訳を表示。
* *「セッション `run-001` はなぜ失敗した？」* → `events --session-id run-001 --all` + `evals --session-id run-001`。
* *「今週の品質トレンドはどう？」* → `evals --aggregate --since 7d` を実行し、スコアの低いランについて詳細を確認。
* *「イベントのプッシュのみ可能なキーを CI に発行して。」* → `keys create ci --add events:add`（コマンドを提示してから作成し、ワンタイムシークレットを取得）。
* *「誰がアクセスできる？Dana を読み取り専用にして。」* → `users list` → `users update dana@… --permission-set read-only`（あなたに確認した後）。
* *「発火中のインシデントを確認して自分にアサインして。」* → `incidents list --state firing` → `incidents ack <id>` / `incidents assign <id> you@…`。

これらの背後にある正確なコマンド、フラグ、JSON の形式については、[cli.md](/ja/agenteye/cli) および [cli-recipes.md](/ja/agenteye/cli-recipes) を参照してください。

***

## 関連ドキュメント

* **[CLI](/ja/agenteye/cli)** — `agenteye` のコマンドとフラグの完全なリファレンス。
* **[エージェント向け CLI レシピ](/ja/agenteye/cli-recipes)** — コピー＆ペーストで使える `jq` パターンと終了コードの処理。
* **[AI アシスタント](/ja/agenteye/assistant)** — ダッシュボード内アシスタント（このターミナルスキルとは異なります）。
* **[API キー](/ja/agenteye/api-keys)** — スキルの実行可能範囲を決める組織ごとの権限モデル。