Claude Managed Agentsで毎朝の自動化を任せる前に、静かに壊れる8つの失敗を知っておく

出典: Managed Agentsの自動化構築を解説（まさおAIじっくり解説ch）

毎朝の要約を、自分のパソコンではなくAnthropic側のクラウドに置くと、どんな作りになるのでしょうか。題材は、Claudeの開発者ブログの記事です。まさおさんはそれを、日本語のスライドに組み直して解説しています。antとManaged Agentsの関係は、antとManaged Agentsの本当の価値で読めます。

前提は、手元にagent.mdなどの定義を用意し、AnthropicのCLIであるantでデプロイすることです。毎朝の要約のような仕事をクラウドに置けば、チームで同じものを動かせます。パソコンの力が足りない時にも便利だそうです。

作りの中心は、毎回まっさらなsandboxに、メモリの部分が差し込まれることです。トークンは、vaultから呼びます。

まさおさん（動画の中で・2:42〜）

毎回ね、え、真っさらな[sandbox]に対して、ま、ここのメモリののね、部分が差し込まれていくみたいな、え、作りになっていたりします

公式サンプルは平日7時32分に動きます。どこまで読んだかはストアに残し、人が書く書き方のルールは、別のストアに分けてありました。

agent.mdは設定ファイルで、動かすのはdeploymentです。どのエージェントを、どの環境で、いつ動かすか。使える上限やvaultも、deploymentの側で選びます。12:24には、動いているのはdeploymentだと押さえてほしい、という言葉がありました。

まさおさん（動画の中で・11:45〜）

この[Managed Agent]っていうのは[agent.md]でですね、エージェントのね、設定ファイルみたいな形になってるんですけど、動かしていくのは[deployment.md]で

ストアは読み取り専用にもできます。人がルールを書き、エージェントは読むだけ。自由に書かせるストアは別にするそうです。

12:24の言葉は、設定ファイルを書いただけでは毎朝の仕事は始まらない、という意味に見えます。仕事の中身を決めることと、いつどこで動かすかを決めることは、別の作業です。毎朝の仕事に置き換えるなら、頼む中身を書いたものと、いつ動かすかの予定は、別々に持つ形になります。分けて考えておけば、止まった時に見る場所も分けられます。

毎日決まった時刻にAIが自動で動く仕事を、私は Cockpit という道具で動かしていて、自動便と呼んでいます。10月12日に数えると、有効な自動便は133本ありました。そのうち128本は、毎回新しい作業として始まります。sandboxと同じ始まり方です。

そのままでは、決めたことも次へ届きません。私の自動便でも、それが起きていました。前の便で私が質問に答えて決めたことが、次の便に届いていなかったのです。

今は、私が答えた決定を、AIを使わずに仕事ごとのメモへ1行ずつ残しています。新しい便が始まる時に、そのメモの新しい10件を差し込みます。10月4日からの作りです。

並べてみると、動画のメモリストアと私のメモは、差し込む時が同じです。どちらも、仕事が始まる時に入ります。前の回までのことを、次の回へ渡すためのものです。動画では、人がルールを書くストアと、エージェントが自由に書くストアを分けていました。私のメモは、人が決めたことをエージェントが読むだけの側に近いと思います。書かせすぎないという考え方は、決めたことを人の側で持っておく、という意味だと考えています。

未読の大事なメールを拾う朝の自動便は、メールを読むだけで、最後に1本の報告を出す形です。前は毎日でした。私の選択で、9月28日から週1回にしました。月曜の7時です。

動画の分け方に重ねると、週1回に変えたのは、いつ動かすかの側にあたります。何をするかとは、別に決められます。

前の回で決めたことが、次の回に届いているでしょうか。動いているかどうかとは、別の問いです。設定と動かす場所を分けるように、決めたことの置き場も、仕事の外に分けておきたいと考えています。毎回まっさらに始まる仕事では、決めたことは、次の回に差し込まない限り残りません。

毎朝7時に、前の24時間ぶんを読む作りを考えてみます。起動が数分遅れたら、何が起きるでしょうか。

4:18ごろから、話は公式記事が挙げるポイントに移ります。24時間以内の情報をそのまま読む作りだと、何かの事情で1日ずれた時に、間の1日をどうするかが問題になります。まさおさんの答えは、状態ストアでした。

スライドでは、静かに壊れる失敗が8つ並び、8つとも読む人に警告が届かない、と整理されています。新着の取りこぼしや、読めない日が「何も無い日」に見えることも、その一部です。

記憶の話では、まさおさん自身の経験が出てきます。毎朝7時に24時間以内を読ませると、起動のタイミングで1〜3分ずれることがあるそうです。そのずれが、穴になります。

まさおさん（動画の中で・8:29〜）

これで僕も経験あるんですけど［…］毎朝7時で24時間以内のコンテンツをってやった時に途中のね、ま、起動時間のタイミングであったりだとか、ま、1分3分とかずれたりだとかして、ま、穴がね、生じてしまったりすることもあるわけなんですよ

約8:28の図では、固定の24時間で読むと、火曜の7時32分から9時10分までが誰にも読まれない穴になっていました。そこで、ストアに「しおり」を置きます。前回の「しおり」から読めば、遅れた日は読む期間が伸びるだけです。

分身AI.comの毎日の日記ブログを書く自動便は、16時に起きて、その日の出来事を探す作りでした。材料の日記や記録は、夜に書かれます。当日を探すと、毎日必ず「0件」になっていました。

AIに頼んで、指示を直してもらいました。日本時間の前日を探し、空なら直近3日まで遡ります。3日とも空の時だけ、確かめた日付を全部書いて止まります。

その日記ブログは、9月4日から9月17日まで、公開が「0件」でした。原因はいくつも重なっています。当日を探して毎日空になる作りは、そのうちの1つです。

動画の穴と私の便の穴は、起き方が違います。動画では、起動が数分遅れて、間の時間に穴ができます。私の便は、まだ材料が書かれていない日を探していました。読むべき日を読めていないのは同じです。同じ種類の穴だと受け取っています。

毎朝の仕事が、まだ材料の無い時刻に起きていないでしょうか。起きる時刻と、材料ができる時刻は、別々に決まることがあります。直した後の便は、「しおり」ではなく、前日から遡る作りです。3日とも空なら、どこまで確かめたかが残ります。

ブックマークを記事にする自動便では、9月10日から11日間、新しいブックマークを1件も取り込めていませんでした。取り込む仕事が別の便の中にしかなく、その便が止まっていたからです。記事にする便は、動き続けていました。使っていたのは、8月の在庫です。

止まっていたのは、手前の取り込みです。記事を作る便が動いている限り、外からは止まっていることが分かりにくかったと考えています。

AIに頼んで、取り込みを毎朝のまとめ処理へ移しました。それでも今、取り込みが失敗した時は、ログに警告が残るだけです。人に知らせる仕組みはありません。

警告が出なければ、空の日も在庫で回る日も、いつもどおりの日として並びます。穴が開くこと自体より、開いても警告が出ないことのほうが問題だと考えています。

道具から成功の返事が来ました。それで、仕事は終わったことになるのでしょうか。

サンプルのagent.mdは、3点を禁じています。まず、HTTPで200が返っても成功扱いにしないこと。見るのは、本文のokのフラグです。別のトークンを探さないことと、認証や接続の失敗をメモに残さないことも並びます。メモがノイズになるからです。しかも、残り続けます。

まさおさん（動画の中で・9:23〜）

[agent.md]をね、見ていくとhttpでね、200が返ったからといって成功扱いしないようにしましょうと

サンプルでは、まず過去の投稿を履歴で探します。無ければ先にpostingと記録し、投稿してから「しおり」を更新する流れです。

約10:27のスライドでは、読めなかった情報源を「読めなかった」として先へ進みます。投稿は、届いたと確かめてから記録します。その前のスライドには、読めない日が「何も無い日」に見える失敗も並んでいました。

7月23日、自動便の設定を変えた時のことです。道具は成功を返しました。ところが、AIが読み直すと、変更は書き込まれていませんでした。

9月28日にメールの自動便を週1回へ変えた時も、似たことが起きています。AIが読み直すと、前の毎日の予定が残っていたのです。AIが入れ直し、そのあとで確かめました。

200で成功扱いにしない、という禁止は、この2回と同じ形をしています。返事は成功でした。書き込まれた中身は、違っていました。返事だけを見ていたら、この違いは表に出ません。

「読めなかった」と「何も無い日」を分ける話は、メールの自動便の報告と重なります。失敗した日は「FAILED」です。拾う物が無かった日は「SKIPPED」と、分けて報告します。

2つを同じ言葉で返したら、どうなるでしょうか。読めなかった朝が、何も無い朝にまぎれます。スライドが避けたいとしていたのは、この失敗です。報告を受け取る側にとって、2つは次にとる動きが違います。

失敗を知らせる係の呼び出しも、7月4日の誤った削除で古い版に戻り、7月8日に元に戻るまで、自動便44本ぶん空振りしていました。

日記ブログの自動便は、同じ日の記事を二重に出さないために、日付ごとの作業キーを先に決め、同じキーで予約済みか公開済みの証拠がある時だけ、公開を止めます。投稿の前に履歴を確かめるサンプルと、順番は同じです。

頼む前に何を決めておくかは、ChatGPT dotsに頼む前に決めておく事で読めます。成功の返事は、終わりの合図とは限りません。道具の返事と、仕事が本当に終わったかどうかは、別のものです。読み直して確かめるところまでを、任せた仕事の終わりにしておきたいと考えています。

鍵と権限の話です。毎日無人で動く仕事に、どこまで触らせていいのでしょうか。

トークンはvaultに置かれ、エージェントは直接キーを読まずに、APIを使えます。environment側では、ネットワークへの通信も絞れます。

まさおさん（動画の中で・6:47〜）

基本この[vault]っていうのが置いてくれているんでですね、ま、エージェントが読まないでもこのね、トークンとかを使っていける、そういう仕組みになっておりますんで

11:12ごろからは、読み込みだけの権限の話です。毎日クラウドで動かすなら、Slackなども読み込みだけにしておけば、好き勝手には書き込めません。必要に応じて権限を設定する、と公式が言っているそうです。

まさおさん（動画の中で・11:14〜）

クラウド上でですね、もう毎回毎日のように実行とかをしていくんやったら［…］え、読み込みオンリーみたいな形でやっておくと、ま、あの、究極暴れまくることはできないじゃないですか

約11:27のスライドは、承認待ちで止めず、そのぶん権限を絞る、という整理です。無人で動き続ける代わりに、トークンは読み取り専用にし、web系のツールは切っておく組み合わせでした。

50kgダイエットの公式LINEには、読者に返事をするAIの仕組みがあります。鍵は、Macのキーチェーンから読みます。画面にも記録にも出しません。1日に使うトークンの上限も決めてあります。超えたら、AIを使わずに決まった文で返します。

鍵が入れば、ClaudeのAPIを直接呼ぶ作りです。ただ、10月11日の時点で、その鍵はまだ作っていません。置き場はvaultと違っても、鍵を画面や記録に出さない考えは、動画の話と重なる部分があります。AIにパスワードを見せない方法は、1PasswordでAIにパスワードを見せない方法で読めます。

鍵や秘密のファイルにAIが触れようとすると止める仕組みも、入れてあります。この記事の材料を集めている間にも、その仕組みが、AIが打った確認のコマンドを2回止めました。確認のためのコマンドも、例外ではありません。

承認待ちで止めない側は、決まりにできました。私の返事待ちのまま24時間を超えた自動便は、止めて置いておきません。仕組みの担当へ引き渡してから終わります。有効な自動便のうち、25本にこの決まりが入っています。

スライドの整理では、止めないことと権限を絞ることが、組みになっていました。私の自動便は、片方だけが先に進んでいます。

権限を絞る側は、まだ途中です。83本の自動便は、道具を使うたびの承認なしで動く設定になっています。メールの自動便の「読み取りのみ」も、AIへの依頼文に書いた禁止です。鍵の権限そのものは、絞っていません。

依頼文の禁止は、AIに伝えた約束です。読み取り専用のトークンは、書き込む力そのものを持たせません。動画が話していたのは、トークンの側だと考えています。

権限そのものを絞った例は、dotsにメールを預けるなら読み取り専用からで読めます。ただ、dots以外は、まだ途中です。

承認なしで動く83本は、任せられた証拠にはならないと考えています。絞り切るまでは、先に確かめることがあります。それぞれの仕事が、何を変えられるかです。そこまでが、任せる側の仕事だと考えています。

自走は、人が見守ること自体では壊れません。「私が見て育つ」から「私が見ないと止まる」へ変わり、結論を出す責任が人へ戻って、保守が主役になった時に、自己維持へ反転します。

まさおさんの動画は、毎朝の要約エージェントをクラウドに置く話です。この動画の中心は、動かし方より、失敗の見え方にあると考えています。「しおり」で読んだ所を残すこと。届いたと確かめてから記録すること。鍵は見せずに、権限を絞る工夫。どれも、失敗の日を失敗の日として見せるための作りです。

私の自動便でも、日記ブログの公開が無かった14日間や、新しいブックマークを取り込めていなかった11日間がありました。毎朝の仕事を任せる前に確かめたいのは、動かすことよりも、止まった日を止まった日として知らせる作りがあるかどうかだと考えています。

任せた仕事が静かに止まっていても、誰にも気づかれません。任せる前に、それを防ぐ作りを用意しておくのが、任せる側の仕事です。

「私が見て育つ」はずの仕組みが、いつの間にか「私が見ないと止まる」ものに変わっていないでしょうか。自動化を見直す時は、その問いを手元に置いておきたいと考えています。