AI Platform CLI
AI Platform CLIは、ターミナルにコマンドを入力してスキル、エージェント、自動化などを確認・管理するツールです。ブラウザーで利用しているアカウントでログインし、ターミナルではaipctlという名前で実行します。
スキルのファイルをPCにダウンロードしたり、エージェントの設定を変更したり、繰り返し行う確認をスクリプトにまとめたりできます。PCトンネルの接続機能も利用できます。
はじめに
初めて利用する場合は、インストールとログインに沿って進めてください。次の手順で、最初のスキル一覧を確認できます。
- インストールする — Node.jsを準備し、CLIをインストールします。
- ログインする — 接続先のURLを設定し、ブラウザーでログインします。
- 最初のコマンドを実行する — ログイン時に選択した組織のスキル一覧を取得します。
インストールとログインが済んだら、以下から目的の操作を探してください。PCを接続する場合は、PCトンネル接続に進んでください。
利用できるコマンドを確認する
--helpまたは-hを入力すると、利用できるコマンドを確認できます。
aipctl --helpコマンドやグループの後ろに--helpを付けると、サブコマンドとオプションを確認できます。
# スキル関連のコマンドを確認
aipctl skill --help
# スキルのダウンロードに必要な入力とオプションを確認
aipctl skill download --help入力形式や詳しい使い方は、コマンドリファレンスを参照してください。
CLIでできること
| 目的 | 参照先 |
|---|---|
| スキルを探し、ダウンロード・登録する | 一覧・詳細・ライブラリ・アップロード・ダウンロード |
| 組織のスキルをGitHubから取り込み、更新する | GitHubからの取り込みと変更の反映 |
| エージェントの設定を確認・作成・変更する | エージェントの確認・作成・有効化 |
| 自動化の設定と実行履歴を管理する | 自動化の確認・作成・変更・有効化 |
| ファイル・会話・連携・モデルの情報を確認する | リソースの確認とフォルダー管理 |
| 組織を管理し、使用量を確認する | 組織と使用量 |
| PCを接続する | PCトンネル接続 |
| JSON形式の一覧を別の処理で利用する | スクリプトと一覧取得 |
利用前に確認すること
-
ログインしたアカウントと選択中の組織を基準に操作します。 CLIでも、アカウントに付与された権限の範囲でデータを確認・操作できます。複数の組織に所属している場合は、操作する組織が正しいかを先に確認してください。組織で共有するスキルやエージェントの管理には、AI担当者など、その操作を許可する権限が必要です。権限がないという案内が表示された場合は、組織管理者に問い合わせてください。
-
目的の操作に合ったコマンドを確認してください。 例えば、
aipctl model listは利用できるモデルの一覧を、aipctl chat listは自分の会話一覧を表示します。これらのコマンドだけでは、モデルの実行や新しいメッセージの送信は行われません。機能別のガイドやコマンドリファレンスで目的の操作を探してください。 -
利用できる機能は、インストールしたバージョンや組織のサービス環境によって異なる場合があります。 マニュアルのコマンドが見つからない場合は、
aipctl --versionでバージョンを、aipctl --helpで利用できるコマンドを確認してください。コマンドが存在しても実行が拒否される場合は、表示されたエラー内容を確認します。制限事項とトラブルシューティングでは、状況別の確認方法を説明しています。
コマンド例の読み方
aipctl skill get SKILL_IDSKILL_IDのように大文字で書かれた部分は、実際の値に置き換えて入力します。この例では、スキル一覧で確認したIDを使用します。空白を含む名前や文章は引用符で囲んでください。
コードブロックのコマンドをコピーしてターミナルに貼り付け、Enterキーを押すと実行できます。複数行ある場合は1行ずつ実行し、結果を確認してから次の行に進んでください。