公式は、2つの部品を分けています。
| 何のことか | たとえ | |
|---|---|---|
| スキル | 仕事のやり方を書いた、使い回せる手順書 | 引き継ぎ用のマニュアル |
| 定期実行 | 1体のボットに、時刻か出来事で決まった仕事をさせる設定。公式は routine | 「毎朝8時にこれをやって」という当番表 |
スキルは「どうやるか」、定期実行は「いつ・誰が」です。 組み合わせて使うのが基本です。 公式が勧める順は3段です。まず1回の仕事で確実にします。次に手順をスキルに保存し、それから自動化します。
No.07で見たとおり、Slack や webhook などの出来事でも定期実行は始まります。 この単元では、定期実行そのものの中身(作り方・数字・使用量)を扱います。出来事の入口の種類は、No.07へ戻って確かめてください。
スキルには、手順・判断のルール・期待する出力・安全の境界が書かれます。 公式は、役に立つスキルに次の6項目があると書いています。
6つ目が、特に大切です。 「お客さんへの連絡は必ず承認」のような一文を手順書に書いておくと、定期実行で無人で走る時にも、止まる場所が決まります。
スキルは、あなたの全ボット共通の私的ライブラリです。 ただし、ボットがその連携アプリやログインを持っていなければ使えない場合があります。ボットが私的スキルを見つけられない時は、Connect apps の接続数から、そのボットに対して有効にします。
チームに入っていれば、私的スキルを公開して同僚が使えるようにできます。 公開には 説明文が必須 です。同僚とそのボットが、「いつ当てはまるか」を説明文で判断するからです。
公開後は、ボタンが Published に変わります。 メニューからは、あとの編集をチームの版へ反映する Sync が使えます。Copy link と Unpublish も使えます。 チームへ入っていない場合や、管理者がメンバーの公開を止めている場合は、公開が断られて理由が出ます。
Teach a task が使える時は、ブラウザ作業を言葉で説明する代わりに、1回やって見せて教えられます。 画面で行った操作が、最大10分まで記録されます。マイクの音声は録りません。 手順の途中で秘密を見せないよう、認証情報は別の安全な受け渡しを使います。
記録からできるスキルは、あくまで下書きです。 1回の例では見えない判断のルール・失敗時の扱い・承認の境界は、あなたが足します。段階的な提供のため、ボタンが見えないこともあり、その時は文章の指示と終えた作業からスキルを作らせます。
講師向け:「見せるだけでいいんですか」と聞かれたら、「下書きになります。判断の基準と止まる所は、人が足します」と答えられます。
定期実行は、持ち主にしたいボットに頼んで作ります。 決める物は、どのボットが・いつ(時刻か出来事)・何を、の3つです。公式は、次の6点も確かめるよう勧めています。
時間帯は、Settings → Bot の Timezone にある設定で決まります。Auto-detect は this computer に従う、と公式は書きます。設定画面を開いている端末のことと読めますが、公式は説明していません。事務所の時間に合わせたい時などは、地域を選びます。
作った瞬間には走りません。 次の予定の時刻まで待ちます。 8時5分に「毎日8時」で作ると、最初の実行は翌日の8時です。すぐ試す時は Test を使いますが、Test は本物の作業を行います。サイトを開き、ファイルを書き換え、連携アプリを呼びます。安全な入力で、書き込みは承認を挟んで試します。
定期実行は、あなたのパソコンを閉じていてもクラウドで走ります。 Test が見えない定期実行は、予定どおりに走るだけです。その場合は、チャットで同じ作業を安全な入力で1回やらせ、最初の実行を確かめます。
数字は覚えずに、考え方で持ちます。
| 項目 | 上限 | 講座の読み方(公式に理由は書かれていません) |
|---|---|---|
| 1ボットの定期実行 | 50件 | 1体に持たせすぎない |
| 予定の間隔 | 5分以上あける | 細かく回しすぎない |
| 履歴 | 各定期実行の直近20件 | アプリが持つのは直近20件(原文) |
| 1件あたりの速度 | 1時間に200回 | 暴走する1件を止める |
| 全定期実行の合計 | 1時間に300回 | 全体の暴走を止める |
どちらかの速度制限を超えた走りは、Automation run rate limit exceeded で失敗します。
この失敗は自動では再試行されません。 Test で今すぐ走らせるか、webhook なら送り直します。1つがいつも制限に当たる時は、入口を狭めるか、予定を間引くようボットに頼みます。
自分の定期実行が少なくても、全 Grok Bot 共通の上限のためにこのエラーが出る場合があります。 公式はこれを、修正中の既知の問題と書いています。
走るたびに使用量を使います。 1時間おきの予定・短い間隔・混んだ Slack チャンネルへの入口は、1日で1週間分を使うこともあります。 Slack の「全メッセージ」の入口が危ない理由は、これです。
走らない定期実行は使用量を使いません。ただし、Test は作業を行うので使います。 使用量が思ったより早く減るなら、まず不要な定期実行を止めます。 次に予定の間隔を広げ、Slack の入口を狭めます。プランを上げるのは、その後です。
長く離れると、Grok Bot が「定期実行を続けますか」と聞くことがあります。 返事が無ければ止まるので、戻ったら止まった定期実行を見直します。
外の出来事 ─┐
├──▶ 定期実行(いつ走るか)──▶ ボットを起こす ──▶ 登録した指示を実行
時刻の予定 ─┘ │ │ (スキルを使うことが多い)
│ 数字の関門 │
│ 50件/5分間隔/ ▼
│ 1件200回/時・全体300回/時 行動の直前に Auto Review(No.08)
▼ │
超えたら失敗。自動の再試行なし ▼
実行される/止まる(下書き・承認カード)
公式は、「信頼のための設計」として次を挙げています。
定期実行そのものを書き換える行動は、Auto Review の審査の対象です。 増やしすぎず、広い入口を避けます。承認の境界をスキルに書いておけば、無人でも止まる位置が決まります。
定期実行が走らない時は、次を順に見ます。
定期実行を消すと、以後の実行が止まり、元に戻せません。ボットを消すと、そのボットの定期実行も消えます。
○ よくある勘違い:作ったらすぐ1回走る、は誤り。次の時刻まで待つ
○ よくある勘違い:Test は試運転なので無害、は誤り。本物の作業をする
○ よくある勘違い:スキルを公開すれば誰でも使える、は誤り。説明文が必要で、ボットに連携やログインが無いと使えないこともある
○ 関係する単元:No.07(出来事の入口)/No.08(止める層)/No.10(秘密)
スキルは6項目の手順書で全ボット共通、定期実行は「どのボットが・いつ・何を」。作った瞬間は走らず、Test は本物の作業。数字は 50件・5分・履歴20件・1件200回/時・全体300回/時で、超えると失敗して自動再試行はない。走るたびに使用量を使う。
問1 「毎日8時」の定期実行を、8時5分に作りました。最初に走るのはいつですか。
問2 Test ボタンについて、正しいのは?
問3 1つの定期実行が、`Automation run rate limit exceeded` で失敗しました。次にどうしますか。
問4 受講生が「Slack の全メッセージで動く定期実行にしたら、使用量が急に減りました」と言います。仕組みからの説明は?
出典:https://docs.x.ai/grok-bot/skills-routines-and-automations / https://docs.x.ai/grok-bot/faq(What is the difference between a skill and a routine?/Can I show a Bot how I do a task?)/ https://docs.x.ai/grok-bot/security(Approvals and Auto Review)