Agents & Manager の記事一覧
複数の AI エージェントを協調させるマルチエージェント開発のカテゴリです。Manager Surface による統率、オーケストレーション設計、暴走やループの防止、無人運用の監視まで、エージェント活用の実践知を集めています。
並列にするか、順番に残すか — 複数エージェントを束ねるときの損益分岐
複数のエージェントを並列で走らせるべきか、直列のまま残すべきか。調整コストと待ち時間短縮の損益分岐をざっくり見積もる式と、4サイト運用での実際の線引き、判定を自動化する小さなスクリプトまでまとめました。
複数エージェントをどう束ねるか: 並列化する仕事と直列に残す仕事の線引き
Antigravity 2.0 で複数エージェントの真の並列実行が可能になりました。ただ全部を並列にすれば速くなるわけではありません。どの作業を並列に分け、どこを直列のまま残すか。依存関係と競合の観点から、破綻しないオーケストレーション設計を考えます。
Antigravity 2.0 の並列エージェントに視覚回帰テストを任せる設計
Antigravity 2.0 の並列オーケストレーションで、実装エージェントとは別にヘッドレスの視覚回帰テストエージェントを走らせる設計を解説します。基準画像の保管と更新、アンチエイリアス由来のフレーキー対策など、運用の勘所も押さえました。
Antigravity エージェントの従量課金が「内部の利用量」と「Stripeの請求」でずれる — 計測の冪等化・遅延吸収・突合の実装メモ
Antigravityエージェントの従量課金で、自前の利用台帳とStripe Meter Eventsの集計が静かにずれていく問題を扱います。冪等キー設計、遅延イベントの吸収、35日ウィンドウ、日次突合ジョブまでを実装単位でまとめた運用メモです。
Antigravity 2.0 のエージェントに任せる前に引く、3本の境界線
Gemini CLI の提供終了を機に Antigravity 2.0 のバックグラウンドエージェントへ移行した際、任せる作業と手元に残す作業の間に引いた3本の境界線を紹介します。停止条件をコードに落とす方法や、運用して見えた誤算も率直に記しています。
並列エージェントが同じファイルに書き込むときの取り合いを防ぐ
並列エージェントが同じファイルへ書き込んで互いの変更を消し合う事故を防ぐために、所有権分割・直列化点・リース方式コーディネータの3戦略を整理しました。ワークツリー分離では足りない理由と、衝突を検出する番兵の置き方まで実装を交えて説明します。
失敗を握りつぶさずに安く回す — Gemini 3.5 Flash を前提にしたエージェント再試行予算の設計
エージェントの再試行を「握りつぶし」と区別し、失敗を分類してから予算の範囲で回す設計です。Gemini 3.5 Flash の速度と価格を根拠に、1タスクあたりの再試行上限とログ、週次の締め直しまでを実装の手順で整理しました。
複数案を出させたあと、どれを採用するか — 検証で裁定する Best-of-N の設計
Gemini 3.5 Flash の速さで、同じ実装を複数案つくらせるのは現実的になりました。難しいのは生成ではなく裁定です。多数決でも自己申告の自信でもなく、検証可能な信号だけで採用案を決める Best-of-N アービターの設計と TypeScript 実装を共有します。
どのエージェントがいくら使ったかを会計する — タスク別コスト帰属の設計
月末の請求は1つの数字でも、Gemini 3.5 Flash で複数エージェントを走らせていると、どのタスクが費用を食ったかが見えません。予算で止めるガードとは別に、使用量をタスク別・サイト別の原価へ帰属させる会計設計を、個人運用の実装と数値で共有します。
並行エージェントの動きを後から辿る — 構造化ログとスパンで作る可観測性
Antigravity 2.0 のデスクトップで複数エージェントを並行させると、どれが何をしているか追えなくなります。混線する print デバッグを捨て、run_id と span で実行を後から辿れるようにする可観測性の設計を、個人運用の実装と数値で共有します。
Managed Agents の無人バッチを再実行で壊さない — 冪等性とチェックポイントの設計
Antigravity 2.0 の Managed Agents API で夜間バッチを組むと、途中失敗からの再実行が必ず問題になります。二重実行で投稿が重複した失敗を起点に、冪等キー・チェックポイントストア・再開ロジックの実装を、個人開発の運用実数値とともに共有します。
Antigravity のエージェント評価ゲートが揺れて信用できないとき — 確率的な揺らぎに負けない合否判定の実装メモ
同じコードなのに評価が通ったり落ちたりする。Antigravity でエージェント評価を CI に組んだとき最初に壊れるのは判定の安定性です。揺らぎを区別し、静かな劣化を捕まえる合否設計を実装で固めます。
Gemini API の Managed Antigravity Agent で多言語リリースノートを生成する実装メモ
Gemini API 経由で公開プレビューになった Managed Antigravity Agent を使い、git のコミットログから App Store / Google Play 向けの多言語リリースノートを生成するパイプラインを実装した記録です。
agy の非同期ジョブで夜間タスクを束ねる — fan-out・poll・join の運用設計
Go 製になった Antigravity CLI（agy）は、ジョブをデタッチして非同期に走らせられます。複数の長時間タスクを一度に投げ、ジョブIDを束ね、完了をポーリングで待ち合わせる fan-out・poll・join の運用設計を、実際の夜間バッチの構成とともに共有します。
Managed Agent をコスト上限つきの使い捨てワーカーとして扱う設計 — 外部入力を本番から隔離する
Gemini API で公開プレビューになった Managed Antigravity Agent を、永続させず1回で捨てる『使い捨てワーカー』として使う設計です。コスト上限・隔離・冪等性を実装の手順とともに整理しました。
Managed Agent の非同期ジョブを、投機実行・検証・採用の三段で受け入れる
Gemini API 経由で公開プレビューになった Managed な Antigravity Agent は、サンドボックス内で自律的に計画・実行・検証します。その非同期な成果物を本番に取り込む前に、投機実行・検証・採用の三段で受け止める設計を、実装コードと運用上の落とし穴とともにまとめました。
Antigravity のエージェントを「完了の自己申告」から卒業させる — 完了契約と外部検証の実装メモ
Antigravity のエージェントが「完了しました」と報告したのに未完了だった事故を、完了判定をコードへ外部化する設計で潰してきました。完了契約・3層の自動検証・無人実行での扱い・CI 統合までを実装で示します。
Managed な Antigravity Agent を Gemini API から呼ぶ — preview モデルの設計メモ
Gemini API で公開プレビューになった antigravity-preview-05-2026 は、サンドボックス内で計画・コード実行・ファイル操作・ウェブ閲覧まで自律で行う Managed Agent です。自前のオーケストレーションと何が違うのか、どこで使い分けるかを設計の視点で整理しました。
Antigravity のマルチエージェントを本番で壊さない封じ込め設計 — 連鎖障害を止める3つの境界の実装メモ
Antigravity のマルチエージェント構成は単体では綺麗に動くのに、本番では小さな失敗が全体に波及します。連鎖障害を止めるための制御の階層化・信頼境界・観測と冪等性という3つの境界を、TOML 設定と相関IDラッパーの実装まで含めて整理しました。
サブエージェントの受け渡しを壊さないスキーマ進化の設計
上流エージェントの出力形式が少し変わるだけで下流が静かに止まる問題に対し、受け渡しの契約をコードで固定し、境界でバリデーションする設計をまとめました。スキーマを進化させる現実的な手順と、本番で起きた症状、再発を防ぐ3つの仕掛けを紹介します。
Managed Agents にクラウドで動いてもらうとき、資格情報をどう渡すか
Antigravity 2.0 の Managed Agents API は、手元を離れたクラウドでエージェントを走らせます。便利な反面、自分の端末では当たり前だった資格情報の扱いが急に難しくなります。長く生きるトークンを直接渡さず、実行ごとに発行して短く失効させるための設計をまとめました。
Managed Agents API のバッチを、途中で落ちても作り直さない形にした記録
Managed Agents API で 200 件規模のバッチを回すと、途中失敗のたびに前半をやり直してトークンを溶かしていました。チェックポイントと冪等キーを足して、落ちた箇所から再開できるようにした設計と実装をまとめます。
「直しました」を信じる前に — 本番URLの描画をエージェント自身に確かめさせる完了ゲート
エージェントが「修正してデプロイしました」と報告したのに、本番ページが真っ白だった。ビルドもデプロイも成功（200）なのに本文が空になる事故を防ぐため、Antigravity 2.0 の Browser Sub-Agent に本番URLを開かせて主要セレクタの存在を確認させる、完了前の検証ステップの組み方をまとめます。
並列エージェントの変更を、後から追えるようにする設計
並列エージェントの変更で「誰が何をしたのか分からない」状態に陥らないための監査トレイル設計です。コミット末尾への追跡メタデータ、人間が見る変更と自動承認してよい変更の切り分け、意図を1行で書かせるプロンプト側の規約まで具体的にまとめました。
エージェントに品質チェックを飛ばさせない — Antigravity CLI Hooks と git pre-push の二段ゲート設計
依存更新を任せたエージェントが、落ちたテストを『無関係』と自己判断して push まで進めてしまった経験から、Antigravity CLI の Hooks と git pre-push を重ねた二段ゲートを組みました。品質チェックの省略を仕組みで防ぐ設定とスクリプトの実物をまとめています。
スケジュール実行のエージェントが二重に走る — 重複と再実行に耐える冪等設計
前回の実行が終わらないうちに次回がトリガーされ、スケジュール実行のエージェントが同じ作業を二重に行うことがあります。重なり防止のロックと、途中失敗からの再実行に耐える冪等化を、実運用で踏んだ二重投稿の事例とともに設計します。
スケジュール実行エージェントの指示書ドリフト — 定義・文書・実態の乖離を検知する三層整合の設計
スケジュール実行のエージェントは、指示書と実態が乖離しても成功ログを出し続けます。定義・文書・実態の三層で整合を検査するスクリプトと週次レビューの組み立てを、運用で踏んだ無音失敗の実例とともにまとめました。
複数エージェントを同じリポジトリで並走させると壊れる — worktree で作業領域を分離する設計
Antigravity 2.0 で複数エージェントを同じリポジトリに同時に走らせると、index.lock の衝突や中途半端なステージングで失敗します。git worktree と projects を使ってエージェントごとに作業領域を分ける分離設計を、実運用で踏んだ事故とあわせてまとめました。
Antigravity SDK で定期実行エージェントを冪等に組む — 二重起動と取りこぼしを防ぐ実装
Antigravity SDK のスケジュール実行は、cron 式を一行足すだけで動きます。難しいのはそこではなく、同じジョブが二重に走ったり、前回の続きを取りこぼしたりせず「何度動いても結果が一つ」になる実装です。個人開発の定期メンテナンスで踏んだ失敗をもとに、冪等な定期エージェントの組み方をまとめました。
AIエージェントの git push が成功表示なのにリモートへ反映されないときの原因と対処
エージェントに任せた git push が「Everything up-to-date」のまま空振りし、リモートに何も反映されない症状について、再現条件と原因、identity 明示・SHA 照合・GitHub REST API という3つの対処をまとめました。
Managed Agents API を動かして考えた、クラウド実行と手元実行の境界線
Gemini API の Managed Agents（公開プレビュー）を Python から起動し、ポーリング・アーティファクト回収・コストガードまで実装した記録です。手元の CLI エージェントとの使い分け基準も5項目にまとめました。
依存ライブラリの更新を Antigravity エージェントに任せる運用設計 — リスク階層・検証・巻き戻し
溜まり続ける依存更新の通知を、Antigravity のエージェントにどこまで任せられるか。semver を実績で補正するリスク4階層、worktree によるロット隔離、検証と巻き戻しの定型化まで、複数アプリ運用で固めた設計を実物のスクリプトつきで共有します。
Antigravity エージェントへの依頼は「レビューできる単位」で切る — 手戻りを減らすタスク設計
1行の依頼で40分待った結果を月曜に書き直した失敗から、エージェントへのタスクを「自分が15分でレビューできる単位」で切る運用に変えました。実際の依頼文3通、受け入れ条件の書き方、worktree 並列時のファイル境界の切り方まで実例で残します。
6 サイトを一人で回すための自律エージェント・スケジュール設計 — 衝突とスパム判定を避ける時間割
個人開発者が 6 つのサイトとアプリ事業を一人で並行運用するために組んだ、自律エージェントのスケジュール設計の実例です。オフピーク分散・1日あたりの生成上限・タスク衝突の回避を、実際の時間割と判断基準からまとめました。
エージェントに渡す道具の粒度を決める — 粗くまとめるか、細かく分けるか
エージェントに渡すツールを細かく刻むか粗くまとめるかを、一回の意思決定で完結するかという軸で考えます。細かすぎるツール群が招く3つの失敗、粗すぎる場合に失う中断の余地を踏まえ、意図1つ＝ツール1つという中間粒度に落ち着いた経緯を詳しく述べます。
やり直せる操作とやり直せない操作を分けて任せる — 可逆性で自律度を決めるエージェント設計
Antigravity のエージェントに本番作業を任せるとき、賢さより先に効いてくるのは「その操作をあとから取り消せるか」です。操作を可逆性で3階層に分け、自動実行・チェックポイント付き実行・人間ゲートへ振り分ける設計を、TypeScript の実装と6アプリ並行運用の実測値つきで整理しました。
Antigravity のエージェント出力からシークレットを漏らさない多層防御 — ログ・差分・PR 本文を守る実装メモ
エージェントがシークレットを漏らす出口を、コミット差分・実行ログ・PR 本文の3つに分けて塞ぐ多層防御の実装メモです。pre-commit と CI での関門づくり、allowlist と entropy による誤検知の抑え方、漏れた後の復旧手順まで記しました。
Antigravity のエージェントに『差分を小さく刻む』癖をつけてもらう — 1ヶ月の運用で変えたレビューの流儀
エージェントが一度に大きな差分を返すと、個人開発ではレビューが追いつかなくなります。Antigravity に『小さく刻んで』と最初に頼むようにして1ヶ月、レビューの体感がどう変わったかを、実際に渡している指示文とともに残しました。
本番に触れる前にエージェントの操作を空振りさせる — 副作用ゼロのドライラン層をどう設計するか
シャドウ実行やカナリアでも防げない事故があります。エージェントが外部APIに初めて触れる、その一回目を安全にするための「副作用ゼロのドライラン層」を、Antigravity の並列エージェントに後付けで差し込む設計と実装を、6サイト自律運営の実数値とともに共有します。
並行エージェントのトークンコストを予算で抑える — 暴走を止めるバジェットガードの設計
複数のエージェントを並行で走らせると、トークン費は気づかないうちに膨らみます。トークンを減らす最適化ではなく、予算で消費を遮断するガバナンス層を Antigravity の並列エージェントに組み込む設計と実装を、運用で決めた閾値とともに共有します。