---
title: "AIエージェントによるAuth0 CLIの操作を「エージェントモード」で最適化
"
description: "AIコーディングエージェント専用に構築された構造化JSON、スキーマチェック、予測可能なエラー回復など、Auth0 CLIのエージェントモードについて解説します。"
authors:
- name: "Bharath Natarajan"
url: "https://auth0.com/blog/authors/bharath-natarajan/"
- name: "Kunal Dawar"
url: "https://auth0.com/blog/authors/kunal-dawar/"
- name: "Ramya Anusri Ankisetty"
url: "https://auth0.com/blog/authors/ramya-anusri-ankisetty/"
date: "Oct 20, 2026"
category: "Announcements"
tags: ["cli"]
url: "https://auth0.com/blog/jp-your-agent-can-better-drive-auth0-cli-with-agent-mode/"
---
# AIエージェントによるAuth0 CLIの操作を「エージェントモード」で最適化
>本記事は「[Your Agent Can Better Drive the Auth0 CLI with Agent Mode](https://auth0.com/blog/your-agent-can-better-drive-auth0-cli-with-agent-mode/)」を翻訳した記事です。
エージェントが新しいアプリケーションをセットアップする場面を想像してください。CLIで何ができるか全くわからないため、推測を始めます。`--help`を実行し、さらに1つ深いレベルで`--help`を実行し、それを繰り返します。5回の検索の後、必要なコマンドを見つけます。次に、実際のフィールド名を教えてくれるものがないため、自分で作成したフィールド名を含むペイロードを送信します。APIは400エラーと文章で拒否します。エージェントは文章を読み、再び推測します。
エージェントが操作する以前のAuth0 CLIの姿です。すべてのステップでラウンドトリップが発生し、すべての失敗で推測が必要でした。
CLIは、人がキーボードの前に座り、手動でコマンドを試し、エラーを読み、調整することを想定して構築されました。現在、CLIに到達するトラフィックの多くは、代わりにエージェントから来ています。[Claude Code、Cursor、CIジョブ](https://auth0.com/blog/integrating-claude-code-with-auth0-apis/)などです。以前の前提により、馴染みのないコマンドはすべて試行錯誤に変わりました。
推測に加えて、スペルミスのあるコマンドはヘルプテキストを出力し、何も問題がなかったかのように`0`で終了していました。終了コードをチェックするスクリプトは、実行されなかったステップの上に次のステップを構築していました。
エージェントモードは、推測と誤ったシグナルを修正します。本記事で利用可能な機能は以下の通りです。
## One Switch, Not Five Flags
エージェントは人間のコーダーとは異なるニーズを持っているため、エージェントに`--agent-mode`を使用させ、一度にAuth0 CLIを理解し始められるようにします。
```bash
auth0 apps list --agent-mode
```
`--agent-mode`（または環境変数としての`AUTH0_AGENT_MODE=true`）は、構造化JSON出力を有効にし、対話型プロンプトと色を無効にし、実際の失敗時にゼロ以外の終了コードを保証します。
*常に指定する必要はありません。* エージェントモードは、フラグ、`AUTH0_AGENT_MODE=true`、またはCLIが既知のコーディングエージェントによって操作されていることを認識したときに有効になります。エージェントとハーネスは通常、`AGENT_NAME=CLAUDE_CODE`のような識別子を持つサンドボックス環境でAuth0 CLIを実行します。CLIは自動的に識別子を読み取り、エージェントを検出します。人がCLIコマンドを実行する場合、またはスクリプトやパイプで実行される場合、引き続き通常のテーブルを出力します。
**エージェントで試す。** *"Auth0 CLIを使用してアプリケーションを一覧表示し、存在しないリソースを一覧表示して、取得した終了コードを教えてください。"*
## A Map of the Whole CLI in One Call
エージェントは単一のコマンドでCLIで利用可能なすべてのコマンドを取得できます。
```bash
auth0 commands --flat
# or
auth0 commands --detailed
```
`auth0 commands --flat`を使用すると、エージェントは実行可能なすべてのコマンドのリストをそれぞれの行に取得します。スキャンやインテントマッチングに最適です。
`**--detailed**`を使用するすべてのコマンドは、フラグ、引数、デフォルト、認証が必要かどうかなど、完全な呼び出しの形式をエージェントに提供します。
2つのフラグにより、エージェントは何が可能かを見つけるためだけに数回のラウンドトリップを費やす代わりに、1回の呼び出しでセッションの計画全体を構築できます。
**エージェントで試す。** *"何ができるかを把握し、新しいアプリケーションをセットアップしてください。"*
## Know the Shape Before You Send It
3つの新しいフラグ、`--schema`、`--data`、`--query`により、エージェントは推測せずにリソースを作成および検査できます。アプリケーション、API、ユーザー、ロール、接続、ログ、カスタムドメイン、メールテンプレート、Universal Login、[ACUL](https://auth0.com/docs/customize/login-pages/advanced-customizations)、クライアントグラント、アクションモジュール、セッション、リフレッシュトークン全体で機能します。以下の機能を確認ください。
```bash
auth0 apps create --schema
```
`--schema`は、OpenAPI仕様からライブで取得された、コマンドが期待する正確なペイロードを出力します。ログインする前にも機能するため、エージェントは資格情報を持つ前に呼び出しの形式を確認できます。
```bash
auth0 apps create --data '{"name":"My App","app_type":"spa"}'
```
`--data`は、インライン、ファイルから、または標準入力を介してパイプされた1つのJSONオブジェクトとしてペイロード全体を送信します。リクエストがAPIに到達する前にローカルでデータを検証するため、不正な形式のペイロードは、何が間違っているかを正確に示すフィールドレベルの詳細とともに、すぐに失敗します。
```bash
auth0 logs list --query '{"per_page":5}'
```
`--query`は、コマンドごとのフラグを記憶する代わりに、APIクエリパラメーターのJSONオブジェクトを使用してリストコマンドをフィルタリングします。
**エージェントで試す。** *"CLIを使用して`beta-tester`というAuth0ロールを作成してください。ペイロードがAPIの期待するものと実際に一致していることを確認してください。"*
## Failures with a Code, Not Just a Sentence
エージェントが次のステップを把握できるように、より良いエラーを提供します。何か問題が発生すると、以下のブロックに似たものを受け取ります。
```bash
{"error":{"code":"validation","reason":"local_validation","message":"...","details":[{"field":"name","reason":"property "name" is missing"}]}}
```
すべての失敗には、コードが検査して回復できる安定した`code`が含まれます。`usage`、`auth`、`validation`、`not_found`、`rate_limit`などです。その下にはより細かい`reason`があります。上記の`local_validation`は、リクエストがマシンを離れる前に、CLI自体が問題を検出したことを意味します。ペイロードは一度に複数の場所で失敗する可能性があるため、`details`は単一のオブジェクトではなく、失敗した特定のフィールドの配列です。ローカル検証の代わりにAPIからエラーが返される場合、エンベロープにはHTTPステータスコードを含む`status`フィールドも含まれます。エージェントは構造全体で分岐します。何が起こったかを推測するために英語を解析する必要はありません。
**エージェントで試す。** *"`billing-service`という新しいAuth0 APIをセットアップしてください。"*
## Keep It Light When It Counts
エージェントモードのデフォルトは、読みやすいインデントされたJSONです。
```bash
auth0 apps list --agent-mode --json-compact
```
大量の実行やトークンに敏感な実行の場合、`--json-compact`は空白を削除し、同じデータをより高密度で返します。`auth0 logs tail`のようなストリーミングコマンドは、エージェントモードで自動的にコンパクト形式に切り替わります。
**エージェントで試す。** *"Auth0アプリを頻繁に一覧表示するループで実行しています。応答にかかるトークンを削減する方法を見つけてください。"*
## Documentation Without Leaving the Terminal
`auth0 docs search`は、CLIから直接Auth0の公開ドキュメントをクエリします。
```bash
auth0 docs search "organizations"
```
ログインは不要です。エージェントモードでは、エージェントが直接取得して読み取ることができる生のMarkdown URLで結果が返されます。解析するHTMLや開くブラウザタブがないため、トークンと時間を節約できます。
**エージェントで試す。** *"簡単な質問ですが、Auth0 Organizationsは実際にはどのように機能しますか。調べて短いバージョンを教えてください。"*
## A Couple More Things Worth Knowing
**キーチェーンを必要としない資格情報。** `AUTH0_DOMAIN`とManagement APIトークンまたはクライアント資格情報のいずれかとともに`AUTH0_CLI_AUTH_MODE`を設定すると、CLIはOSキーチェーンに触れたりディスクに書き込んだりすることなく実行されます。キーチェーンを持たないCIランナーやサンドボックス向けに構築されています。
```bash
export AUTH0_CLI_AUTH_MODE=env
export AUTH0_DOMAIN=
export AUTH0_API_TOKEN=
auth0 apps list
```
**開始する前にエージェントにCLIを教える。** CLIをインストールまたはアップグレードした後、スキルインストールコマンドを実行してコーディングアシスタントにAuth0スキルを追加します。これにより、ライブで発見するのではなく、最初のコマンドで規則をすでに知っている状態になります。
```bash
auth0 agent skills install
```
## Try It Today
最新のCLIバージョンにアップグレードし、独自のエージェントをそれに向けます。エージェントモードは、v1.38.0より大きいバージョンのAuth0 CLIで利用可能です。
```bash
brew upgrade auth0
```
フィードバックがある場合は、[issueを開いて](https://github.com/auth0/auth0-cli/issues)ください。チームが調査します。
まだAuth0アカウントを持たない場合は、[無料で作成](https://a0.to/blog_signup)してください。