自動化管理
自動化の設定と実行履歴を確認し、対応するトリガーの自動化を作成・変更したり、有効・無効を切り替えたりできます。アクセスできる自動化と変更権限は、アカウントと組織のポリシーによって異なります。
設定と履歴を確認する
aipctl automation list
aipctl automation list --name "業務整理" --json
aipctl automation get AUTOMATION_ID
aipctl automation get AUTOMATION_ID --json
aipctl automation history AUTOMATION_ID
aipctl automation history AUTOMATION_ID --page 2一覧でIDを確認し、詳細設定と実行履歴を確認してください。一覧は先頭50件を取得し、次のページを指定するオプションはありません。より多くの自動化はウェブで確認してください。実行履歴では、--pageで次のページを取得できます。
トリガーの設定情報を取得する
automation triggersは自動化の一覧ではなく、トリガーの設定に必要なサービス別の情報を取得します。Webhookでは、サービスの種類を必ず指定します。
aipctl automation triggers webhook --service-type GITHUB--service-typeには、GITHUB、JIRA、SALESFORCE、CUSTOMを指定できます。出力された情報を確認し、Webhookの設定に利用してください。このコマンドは、自動化の作成やWebhookの実行を行いません。
ヘルプには外部サービス用の--account-id・--folder-idも表示されますが、現在のCLIではGmail・Outlook・Google Drive・Boxのトリガー設定情報の取得が制限されています。これらの接続設定はウェブで行ってください。スケジュールやマイドライブの設定を取得するために、このコマンドにschedule・my-driveを指定する方法には対応していません。
スケジュール自動化を作成する
先に利用するエージェントを確認します。
aipctl agent list以下をautomation.jsonとして保存し、AGENT_IDを実際のIDに置き換えてください。毎日、Asia/Seoulの午前9時に実行する例です。
{
"name": "毎日の業務整理",
"triggerType": "SCHEDULE",
"agentId": "AGENT_ID",
"prompt": "今日確認する業務を整理してください。",
"triggerProviderType": "SCHEDULE",
"trigger": {
"schedule": {
"timeZone": "Asia/Seoul",
"recurrenceType": "DAILY",
"recurrence": {
"daily": { "frequency": 1, "timeOfDay": "09:00" }
}
}
}
}aipctl automation create ./automation.json
aipctl automation get NEW_AUTOMATION_ID作成結果のIDで、タイムゾーン・周期・エージェント・有効状態を確認します。有効化するとスケジュールに従ってエージェントが実行されるため、先にプロンプトと利用するリソースを確認してください。
aipctl automation enable NEW_AUTOMATION_ID実行後はautomation historyで結果を確認します。作成や有効化に成功しても、個々の実行が成功するとは限りません。
設定を変更する
以下をautomation-update.jsonとして保存し、AGENT_IDを実際のIDに置き換えてください。毎日の実行時刻を午前10時に変更する例です。更新リクエストには、作成時のtriggerTypeを含めません。
{
"name": "毎日の業務整理",
"agentId": "AGENT_ID",
"prompt": "今日確認する業務と優先順位を整理してください。",
"triggerProviderType": "SCHEDULE",
"trigger": {
"schedule": {
"timeZone": "Asia/Seoul",
"recurrenceType": "DAILY",
"recurrence": {
"daily": { "frequency": 1, "timeOfDay": "10:00" }
}
}
}
}aipctl automation disable AUTOMATION_ID
aipctl automation update AUTOMATION_ID ./automation-update.json
aipctl automation get AUTOMATION_ID
aipctl automation enable AUTOMATION_ID更新ファイルには、変更する項目だけでなく、維持する設定も含めてください。変更後は詳細を再確認します。取得結果全体を、そのまま入力ファイルにしないでください。
Webhook・マイドライブ自動化の入力
作成・更新はいずれもJSONファイルを入力しますが、フィールドはトリガーによって異なります。
| 種類 | 作成時のtriggerType | triggerProviderType | triggerに含める項目 |
|---|---|---|---|
| スケジュール | SCHEDULE | SCHEDULE | schedule |
| Webhook | WEBHOOK | WEBHOOK | webhook |
| マイドライブのフォルダー監視 | FOLDER_WATCH | MY_DRIVE | myDrive |
例えば、マイドライブのフォルダーに追加されるPDFを処理する場合は、次の作成ファイルを用意します。AGENT_IDとFOLDER_IDを実際の値に置き換えてください。フォルダーIDはaipctl drive listで確認します。
{
"name": "PDF資料の整理",
"triggerType": "FOLDER_WATCH",
"agentId": "AGENT_ID",
"prompt": "登録されたPDF資料を要約してください。",
"triggerProviderType": "MY_DRIVE",
"trigger": {
"myDrive": {
"folderId": "FOLDER_ID",
"watchSubfolders": false,
"fileNamePatterns": ["*.pdf"]
}
}
}watchSubfoldersはサブフォルダーも監視するかを、fileNamePatternsは対象のファイル名パターンを指定します。ファイルの読み取りと処理に必要なエージェントの設定・権限も確認してください。
Webhookの作成では、webhookにserviceTypeと必要なconfigを指定します。configの項目は、前述のautomation triggers webhook --service-type ...の結果に基づいて作成してください。WebhookのURLや秘密情報は詳細にそのまま表示されない場合があるため、ウェブの接続案内も確認します。
無効化・削除する
aipctl automation disable AUTOMATION_ID
aipctl automation get AUTOMATION_ID
aipctl automation delete AUTOMATION_ID --forcedisableは有効状態を変更します。実行中の処理が直ちに取り消されたことを意味しません。履歴で進行状況を確認してください。
対応範囲
| 操作 | 対応範囲 |
|---|---|
| 作成・変更・削除・有効状態の変更 | スケジュール(SCHEDULE)、Webhook(WEBHOOK)、マイドライブ(MY_DRIVE)トリガー |
| 他の外部サービスの自動化 | 保存済みの詳細を取得できても、CLIでの変更は制限されます。ウェブで設定してください。 |
| 即時実行・実行のキャンセル・Webhook URLの再発行 | その操作が許可された環境で利用できます。 |
トリガー設定には、種類に合う項目を1つだけ指定してください。スケジュール例のscheduleを他の種類にそのまま使わないでください。Webhook・マイドライブの設定は、ウェブの自動化ガイドも参照できます。
即時実行とキャンセル
自動化をすぐに実行したり、実行履歴の特定の処理にキャンセルを要求したりできます。実行が制限されている環境では、ウェブを利用してください。
aipctl automation get AUTOMATION_ID
aipctl automation run AUTOMATION_ID
aipctl automation history AUTOMATION_IDrunは即時実行を要求します。対応するスケジュール自動化などで利用でき、Webhookのように手動実行に対応しない種類では拒否される場合があります。要求の成功は完了を意味しないため、履歴で結果を確認してください。エージェントの実行に伴い使用量が発生する場合があります。
キャンセルするには、履歴の実行番号を指定します。
aipctl automation cancel AUTOMATION_ID SEQ
aipctl automation history AUTOMATION_IDSEQは履歴に表示される整数の実行番号で、自動化IDとは異なります。キャンセル可能な状態か確認してください。完了済みの実行は拒否される場合があり、要求に成功しても外部の処理がすべて終了したとは限りません。最終状態を再確認します。
Webhook URLを再発行する
Webhookを使う自動化であることを確認してから実行します。
aipctl automation webhook-regen AUTOMATION_ID既定ではURLがマスクされます。新しいURLの全文が必要な場合は、非公開のターミナルで次のオプションを使ってください。
aipctl automation webhook-regen AUTOMATION_ID --show-sensitive再実行すると、もう一度再発行を要求します。 最初に発行したURLを表示するだけのオプションではありません。全文が必要かどうかを最初に決めてから実行してください。再発行後は、外部サービス側の送信先URLを更新し、実際の配信結果を確認します。旧URLの使用状況も確認し、URLを含むターミナルやログは共有しないでください。