制限事項とトラブルシューティング
コマンドが失敗した場合は、接続環境・ログイン・組織・権限の順で確認してください。エラーメッセージのコードと案内も参照します。
利用できるコマンドを確認する
aipctl --version
aipctl --help
aipctl skill --help必要なコマンドとオプションは、コマンドリファレンスで確認できます。利用できる機能は、アカウントの権限と接続環境によって異なる場合があります。
| 操作 | 利用方法 |
|---|---|
| スキルファイルの登録・ダウンロード、組織スキルのGitHub連携 | このマニュアルのスキルコマンドを利用します。 |
| エージェントとの会話、マイドライブの転送、エージェントのエクスポート | バージョンとサーバーの提供条件を確認し、制限される場合はウェブを利用します。 |
| 連携のテスト・変更・削除、自動化の実行・キャンセル、キーやURLの再発行 | バージョンとサーバーの提供条件を確認し、制限される場合はウェブで対応する操作を行います。 |
| 通常の会話への新規メッセージ送信・モデル実行・画像生成 | ウェブで実行します。 |
| 接続トークンの準備 | ウェブのPC接続案内を利用します。 |
CLI_OPERATION_NOT_ENABLEDが表示された場合は、現在のバージョンと組織での機能提供状況を確認してください。開発用CLIをインストールするだけでは解消しません。
ブラウザーでのログインが完了しない
- ログインページが開かない場合は、ターミナルのURLを同じPCのブラウザーで開いてください。
- 待機時間を過ぎた場合は、
aipctl auth loginを再実行してください。 - ポート
8484が使用中というエラーの場合は、他のログイン・組織選択処理を終了してから再試行してください。 - ログイン中に接続環境を変更したり、別のターミナルでログアウトしたりしないでください。
aipctl config status
aipctl auth status
aipctl org currentCLI_AUTH_SESSION_CHANGEDの場合は、別の操作でログイン・組織・環境が変更された可能性があります。現在の状態を確認し、目的の環境に再度ログインしてください。
ログインしたのに組織にアクセスできない
org listでアクセスできる組織を確認してください。組織がない場合は、招待と参加の状態を確認します。IP制限のある組織では、許可されたネットワークから利用する必要があります。
aipctl org list
aipctl org use ORG_SLUG権限がない・対象が見つからない
401:ログインと接続先URLを確認し、再度ログインします。403:組織の役割と、対象リソースの利用・管理権限を確認します。404:一覧で現在の組織とIDを確認します。サーバーがその機能に対応しているかも確認してください。
adminを含むコマンドが、すべて同じ権限を要求するわけではありません。組織共有スキル・エージェントの管理はAI担当者、組織使用量の確認は管理者など、操作ごとの条件が適用されます。
リクエストが多すぎるというエラーが出る
429は、リクエストまたは実行の上限超過を示します。待機時間(Retry-After)の案内がある場合は、指定時間を待って取得頻度を下げてください。
- 同じ一覧を短い間隔で繰り返し取得しないでください。
- 複数のスクリプトを実行している場合は、同時実行数を減らします。
- 個人の上限に加え、組織共通の上限で制限される場合もあります。
- 日次上限や終了確認中の実行は、短時間待つだけでは解消しない場合があります。制限が続く場合は、組織管理者やサポート担当者に問い合わせてください。
503は、サービスを一時的に利用できない状態を示す場合があります。エラーを確認し、時間を置いて再取得するか、サポート担当者に問い合わせてください。
一覧やメッセージをすべて確認できない
通常の取得には、応答サイズと処理時間の制限があります。大きな結果は、一部を全体として返さず、エラーで終了する場合があります。
| 状況 | 次の対応 |
|---|---|
| 次のページがある一覧 | ページ指定オプションで続きを取得します。 |
| 検索・フォルダー条件に対応する一覧 | 取得範囲を絞ります。 |
| メッセージが省略される・取得上限を超える | ウェブで会話の全文を確認します。 |
| 自動化が50件を超える | ウェブで一覧を確認します。 |
| 大きなフォルダーの削除が拒否される | 配下を確認し、範囲を分けて整理します。 |
変更中に接続が切れた
outcome=unknown、タイムアウト、Ctrl+Cの後でも、変更がサーバーに反映されている場合があります。
- 作成・変更・削除した対象の一覧と詳細を取得します。
- 実際の反映状態を確認します。
- 反映されていないと確認できた場合にだけ再実行します。
Ctrl+Cやログアウトは、リモート処理や変更の取り消しを保証しません。自動化の有効化・無効化も、実行中の処理のキャンセル完了を意味しません。
409の場合は、対象の状態変更や名前の競合が考えられます。最新の状態を再取得し、変更内容を見直してください。--forceは削除などの実行確認であり、権限や状態の競合を無視するオプションではありません。
サポートへの問い合わせに含める情報
aipctl --versionの結果、OS・CPU、Node.jsのバージョン- 実行したコマンドと発生時刻
- エラーコード・メッセージ・表示されたリクエストID
- 接続環境と対象の種類、変更後に確認した状態
トークン・PAT・認証ファイル・非公開データの内容は隠してください。スクリーンショットに含まれるコマンド引数も確認します。