Skip to Content
Skip to Content
制限事項とトラブルシューティング

制限事項とトラブルシューティング

コマンドが失敗した場合は、接続環境・ログイン・組織・権限の順で確認してください。エラーメッセージのコードと案内も参照します。

利用できるコマンドを確認する

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 current

CLI_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の後でも、変更がサーバーに反映されている場合があります。

  1. 作成・変更・削除した対象の一覧と詳細を取得します。
  2. 実際の反映状態を確認します。
  3. 反映されていないと確認できた場合にだけ再実行します。

Ctrl+Cやログアウトは、リモート処理や変更の取り消しを保証しません。自動化の有効化・無効化も、実行中の処理のキャンセル完了を意味しません。

409の場合は、対象の状態変更や名前の競合が考えられます。最新の状態を再取得し、変更内容を見直してください。--forceは削除などの実行確認であり、権限や状態の競合を無視するオプションではありません。

サポートへの問い合わせに含める情報

  • aipctl --versionの結果、OS・CPU、Node.jsのバージョン
  • 実行したコマンドと発生時刻
  • エラーコード・メッセージ・表示されたリクエストID
  • 接続環境と対象の種類、変更後に確認した状態

トークン・PAT・認証ファイル・非公開データの内容は隠してください。スクリーンショットに含まれるコマンド引数も確認します。

Last updated on