←STELLAR CHART (星海図へ戻る)
Voyage ID: post-191
AI-AGENTS✦ DRAFT (下書き)Difficulty: Level 2

Getting Started with Google Antigravity

Reading: 38 min

## 1. Introduction

この Codelab では、エージェントの時代に開発を支援するために設計されたエージェント型開発プラットフォームである Google Antigravity について学びます。Antigravity 2.0 は AI エージェントの中央コマンド センターとして機能し、アクティビティの起動、モニタリング、オーケストレーションを行う統合プラットフォームを提供します。

2.0 のリリースにより、Antigravity は IDE と統合されたエージェント マネージャーではなくなりました。現在では、エージェント ファーストの時代に向けて設計されたプロダクトの完全なエコシステムとなっています。

    • Antigravity: macOS、Linux、Windows 向けの主力スタンドアロン アプリケーションです。これは、複数のローカル エージェントを並行して管理し、スケジュールされたタスクなどを実行するためのコマンド センターです。前身の Agent Manager とは異なり、Antigravity 2.0 は IDE とは独立して機能するスタンドアロン アプリケーションです。
    • Antigravity IDE: 元のフル機能のエージェント IDE は引き続き利用できます（開発者におすすめです）。エージェント マネージャー、アーティファクト、コードベースの深い理解が付属しています。
    • Antigravity CLI: ターミナルベースのエージェント操作用のコマンドライン インターフェース。このチュートリアルでは、これについては説明しません。
    • Antigravity SDK: デベロッパーが Antigravity を独自のシステムにプログラムで統合するためのツール。このチュートリアルでは、これについては説明しません。

この Codelab では、Antigravity に重点を置き、Antigravity IDE について簡単に説明します。他の 2 つのコンポーネント（Antigravity CLI と Antigravity SDK）は対象外です。

ターミナル ベースのアプリケーションである Antigravity CLI の Codelab に興味がある場合は、Codelab: Antigravity CLI のスタートガイドをご覧ください。

学習内容

    • Antigravity のインストールと構成。
    • エージェントやワークスペースの操作など、Antigravity の主なコンセプトについて説明します。
    • さまざまな設定や好みに合わせて Antigravity をカスタマイズする。

必要なもの

Antigravity はシステムにローカルにインストールする必要があります。この製品は、Mac、Windows、特定の Linux ディストリビューションで利用できます。ご自身のパソコンに加えて、次のものが必要です。

    • Chrome ウェブブラウザ。
    • Gmail アカウント（個人用 Gmail アカウント）。

この Codelab は、あらゆるレベルのユーザーとデベロッパーを対象としています。

2. install

Antigravity をインストールする

Google Antigravity のダウンロード ページにアクセスします。オペレーティング システム（macOS、Linux、Windows）用の Antigravity アプリケーションをダウンロードします。

31e6370c1744fe73.png

インストーラを実行します。次の画面が表示されます。

4783c8ff21fbc6e7.png

Google アカウントでログインします。認証を完了すると、次の内容が表示されます。

12fa8752446a0458.png

[Open Antigravity]（反重力を開く）をクリックします。[安全性とデータの使用] ポリシーが表示されます。[次へ] をクリックします。

8f2fe904767c34b.png

お好みのテーマを選択します。

cc2466b518c241c9.png

Antigravity には、さまざまな Google デベロッパー ツールと連携する一連のプラグインが付属しています。これらのプラグインは、Antigravity が Google のさまざまなデベロッパー ツールと連携するのに役立つ一連のスキルをインストールします。インストールを任意で選択できるプラグインの一覧を次に示します。この Codelab では、これらのプラグインについては説明しません。[Finish] をクリックします。

3919ac5f462a5dfc.png

次のような Antigravity インターフェースが表示されます。

319cf98d41231a82.png

Antigravity IDE をインストールする

必要に応じて、Antigravity IDE をインストールすることもできます。Google Antigravity のダウンロード ページに移動します。Antigravity IDE のダウンロード セクションに移動します。

6d05924ef8098ae.png

Antigravity と Antigravity IDE の両方が正常にインストールされると、ドックに 2 つのアイコン（Antigravity（白い背景）と Antigravity IDE（黒いグリッドの背景））が表示されます。

97b7906262ed8246.png

✧**Linux デベロッパー向けの注:** Linux の .tar.gz バイナリ バンドルを使用してデプロイする場合、セットアップ ランチャーは Antigravity IDE 環境全体をネイティブに自動構成して起動します。アプリケーション メニューには、コード ワークスペースとバックグラウンド エージェントの管理の両方を処理する統合アイコンが 1 つだけ表示されます。

3. Antigravity インターフェイス

準備が整いました。まずは Antigravity の使用に焦点を当てましょう。最初の Antigravity 画面は次のようになります。

4b2ebaf5bbaa6a27.png

このチュートリアルでは、必要に応じて左下の [設定] オプションを使用します。

プロジェクト

まず、Antigravity のプロジェクトのコンセプトについて説明します。これは、右側のペインのインターフェースに「プロジェクトを選択」と明記されているため、重要です。Antigravity はプロジェクト中心のアプローチを採用して、エージェントが適切なファイル、ツール、権限などにアクセスできるようにしています。

プロジェクトは、エージェントの環境とスコープを定義するフォルダの組み合わせです。エージェントを単一のフォルダ内で動作させるのではなく、プロジェクトは 1 つまたは複数のフォルダ（フロントエンドとバックエンドのリポジトリなど）で動作し、エージェントにコードベースに必要なすべてのコンテキストを提供できます。すべてのプロジェクトには独自の分離されたエージェント設定があるため、異なるプロジェクトのセキュリティ設定を個別にカスタマイズできます。

最初のプロジェクトを作成しましょう。ローカルマシンのホーム フォルダに、$HOME/agy2-projects/my-first-project という名前のフォルダを作成します。空のフォルダである必要はありません。

ここでは、プロジェクトを構成するフォルダを定義して、Antigravity で最初のプロジェクトを作成します。最初のケースでは、フォルダは 1 つになります。

下に示すように、[Select Project]（プロジェクトを選択）→ [New Project]（新しいプロジェクト）をクリックします。

8fb15004219d1d6d.png

予想どおり、以下のように [フォルダを選択] が表示されます。

3b194f9234cbf9ca.png

[フォルダを追加] をクリックし、$HOME/agy2-projects/my-first-project などの特定のフォルダを選択します。

f907f3b64cf0d6a0.png

（[Add Folder] を使用して）プロジェクトにフォルダを追加することはできますが、ここでは [Next] ボタンをクリックします。

次のようなダイアログが表示されます。すべてのプロジェクトには独自の分離されたエージェント設定があるため、プロジェクトごとに異なるセキュリティ設定を個別にカスタマイズできます。

45a29e5c40bf3ae7.png

各プロジェクトは、アーティファクトのレビュー、許可されたツール、Model Context Protocol（MCP）サーバー構成に関する権限を、メイン インターフェースの [設定] からアクセスできるグローバル構成から継承します。ただし、これらの権限などをプロジェクトごとに個別に設定できるため、柔軟性が大幅に向上し、特定のプロジェクトのコンテキストとツールをシンプルに保つことができます。

今回は、[デフォルト] オプションを選択します。

次のダイアログでプロジェクトに名前を付けて、[作成] をクリックすることもできます。

529d6c23ef880f5.png

次の画面が表示されます。プロジェクトは、プロジェクト リストとチャット インターフェースに表示されます。モデルを選択したり、+ 記号、@、/ アクションなどで追加のコンテキストを渡したりできることに注意してください。

f2bfdb27bc878643.png

エージェントにメッセージで挨拶すると、エージェントがそれに応じて応答します。

7e4027bd7a9505e3.png

ニュースを取得する別のリクエストがあり、うまく機能しています。

a5b751531e25f2d3.png

会話

プロジェクト（my-first-project）で会話スレッドを開始し、現在、スレッドには一連のメッセージ（ユーザー メッセージとエージェントの回答）が存在します。

左側の会話スレッドがプロジェクトの下にグループ化されていることがわかります。

e650cbd24d8b66ca.png

では、この会話スレッドに名前を付けてみましょう。conv-introduction という名前を付けます。

会話の横にあるその他アイコンをクリックします。3 つのオプションが表示されるので、[名前を変更] を選択します。

244d0bd0fce7a213.png

値として conv-introduction またはわかりやすい名前を指定します。

プロジェクトで完全に新しい会話を開始する場合は、次の図に示すように、プロジェクトの横にある +（プロジェクトで新しい会話を開始）アイコンをクリックします。

7b834450020d8c03.png

これで、まったく新しい会話が始まります。

世界中のスポーツ ニュースをいくつか聞いてみましょう。まだ my-first-project にいることに注意してください。

4b3208b40a03b6d1.png

スポーツ界のニュースが表示されます。同じプロジェクトに 2 つの会話スレッドがあることがわかります。

aaf65af4b2791423.png

この会話の名前を conv-sportsnews に変更しましょう。これまでのすべての会話を確認するには、次の図に示すように、左上の [会話履歴] をクリックします。

3ed91bba75d70871.png

いつでも、上部の [新しい会話] オプションを使用して、現在のプロジェクトまたは新しいプロジェクトで新しい会話を開始できます。

プロジェクトの設定

それでは、先ほど説明したプロジェクト設定に戻りましょう。Antigravity でプロジェクトを作成すると、デフォルトの権限が継承されます。必要に応じて、この権限を明示的にオーバーライドできます。

特定のプロジェクトのプロジェクト設定にアクセスするには、左側のナビゲーション バーで各プロジェクトの横にある設定の歯車アイコンをクリックします。

7f7158d07780eba9.png

これにより、次の図に示すように、特定のプロジェクト（my-first-project など）の設定が表示されます。

d73f96c9f4f8f61b.png

左側の [プロジェクト] で、[my-first-project] が選択されていることを確認します。プロジェクトが複数ある場合は、このリストの下に表示されます。プロジェクトを簡単に選択して、必要に応じて設定を調整できます。

次に、右側の my-first-project のプロジェクト設定に注目します。このプロジェクトに追加した単一のフォルダが表示されます。ここからフォルダを追加することもできます。

まず、リスト全体を確認して、プロジェクトのカスタマイズ要件に応じて多数の設定を変更するのに役立つ柔軟性を確認することをおすすめします。

たとえば、次のようなものが挙げられます。

    • セキュリティ プリセット: エージェントがアクションを実行する前に、すべてのターミナル コマンドとファイル アクセスを審査するかどうかを指定します。
    • エージェントの動作: エージェントが実装計画をレビューなしで実行するかどうかを決定します。
    • さまざまなローカル権限: エージェントで許可またはブロックされるファイルパス、URL など。
    • このプロジェクトで許可される特定の MCP ツールを構成することもできます。これは、このプロジェクトのエージェントでグローバルに構成されたすべての MCP サーバーを使用できないようにする場合に非常に便利です。
✧**注**: Antigravity インターフェースのメイン設定オプションから、Antigravity の設定やプロジェクトの設定にいつでもアクセスできます。

9632f5815b5f00c5.png

スラッシュコマンド

Antigravity には、興味深いスラッシュ / コマンドがいくつかあります。会話チャット インターフェースで「/」と入力すると、次のようにコマンドが表示されます。

a6b3198f2b693d8d.png

/browser コマンドについて考えてみましょう。これは、ブラウザを起動して何かを実行するように指示する明示的なコマンドです。デバッグ セッションを開始するには、Google Chrome と Google Chrome での権限が必要です。

1a23771f8cc1f7d2.png

これにより、Chrome でデバッグ セッションを開始しようとするブラウザ サブエージェントが生成され、最初に権限を求められます。

1380710b74477b94.png

許可すると、必要に応じて権限をリクエストし、詳細を取得します。

8620b739bc192f7.png

6d592e977d54337b.png

/schedule コマンドは、エージェントが一定の間隔またはスケジュール（月曜日と水曜日の午前 9 時など）で実行する定期的なタスクまたは 1 回限りのタスクを設定する場合に便利です。

同時に、ユーザー インターフェースを使用してこれを行うための同じ機能が提供されます。これについては、次のステップのコマンドのスケジュール設定セクションで説明します。

コマンドのスケジュール設定

MCP(Model Context Protocol)サーバー

MCP とは、

    • エージェントを外部システムに接続するための標準として登場。
    • エージェントがデータと統合の点でグラウンディングを維持するうえで、重要な役割を果たす。

Antigravity では、ローカルとリモートの両方の MCP サーバーをサポートしています。また、Google Cloud サービスと連携する複数の MCP サーバーとの統合も提供されており、数個の構成データでワンクリックでインストールできます。

どう追加するか？

    • [左下のSettings → Customizations] に移動し、[Add MCP+] ボタンをクリックして新しいサーバーを追加できる。ダイアログが表示され、事前構成済みの完全なリストが表示されます。
    • バックグラウンドでは、MCP サーバーは $HOME/.gemini/config/mcp_config.json ファイルで構成されます。既存のリモート MCP サーバーを使用している場合は、このファイルに詳細を追加するだけです。カスタム MCP サーバーの構成については、こちらをご覧ください。

    • 例えば、Cloud Run MCP：「Enable Antigravity to deploy apps to Google Cloud Run.」とあるように、
    • 構成した MCP サーバーを使用するには、MCP サーバーを必要とする質問を Antigravity にします。たとえば、cloudrun-mcp サーバーを有効にして、Antigravity に「Build and deploy a Cloud Run service」と質問できます。これにより、Antigravity は cloudrun-mcp サーバーを探して使用し、Cloud Run サービスを構成してデプロイします。

アーティファクト

Antigravity は、作業を伝達して人間のユーザーからフィードバックを得る方法として、作業を計画して実行する際にアーティファクトを作成します。リッチ マークダウン ファイル、アーキテクチャ図、画像、ブラウザの録画、コードの差分などがあります。

アーティファクトは信頼のギャップを解消します。以前は、エージェントがバグを修正したと主張した場合、デベロッパーはコードを読んで確認する必要がありました。Antigravity では、エージェントがアーティファクトを生成して証明します。

Antigravity によって生成される主なアーティファクトは次のとおりです。

    • Task Lists: エージェントは、コードを記述する前に構造化された計画を生成します。通常、このプランを編集する必要はありませんが、確認することはできます。必要に応じて、コメントを追加して変更することもできます。
    • Implementation Plan: コードベース内の変更を設計してタスクを完了するために使用されます。これらのプランには、必要な修正に関する技術的な詳細が含まれており、アーティファクトの審査ポリシーが [常に続行] に設定されていない限り、ユーザーが確認することを想定しています。
    • Walkthrough: エージェントがタスクの実装を完了すると、変更の概要とテスト方法がまとめられたものが作成されます。
    • Code diffs: 厳密にはアーティファクトではありませんが、Antigravity はコードの差分も生成します。この差分を確認してコメントを追加できます。
    • Screenshots: エージェントは、変更前後の UI の状態をキャプチャします。

アーティファクトをより深く理解するには、次のプロンプトを使用して、新しいプロジェクトまたは既存のプロジェクトで会話を作成します。

Write a node application that I can run from the command line to get me the latest news from Google.

エージェントが飛び立ち、最初の成果物である実装計画を持って戻ってきます。

飛ばしてます。

Antigravity IDE

IDEも使えます。

Skill

Antigravity の基盤となるモデルは強力な汎用モデルですが、特定のプロジェクトのコンテキストやチームの標準を把握しているわけではありません。すべてのルールやツールをエージェントのコンテキスト ウィンドウに読み込むと、ツールが肥大化し、コストが増加し、レイテンシが発生し、混乱が生じます。

スキルは、プログレッシブ開示によってこの問題を解決します。スキルは、必要になるまで休眠状態にある専門知識のパッケージです。特定のリクエストがスキルの説明と一致した場合にのみ、エージェントのコンテキストに読み込まれます。

構造とスコープ

スキルはディレクトリ ベースのパッケージです。必要に応じて、次の 2 つのスコープで定義できます。

    • グローバル スコープ（~/.gemini/config/skills/）: すべての Antigravity プロダクト（Antigravity、Antigravity IDE、Antigravity CLI）とプロジェクトで使用できます。
    • プロジェクト/ワークスペースのスコープ（<project-root>/.agents/skills/）: スキルを特定のプロジェクト内でのみ利用できるようにします。

＃＃＃＃　スキルの構造

一般的なスキル ディレクトリは次のようになります。

my-skill/├── SKILL.md    #(Required) metadata & instructions.├── scripts/    # (Optional) Python or Bash scripts for execution.├── references/ # (Optional) text, documentation, or templates.└── assets/     # (Optional) Images or logos.

スキルを追加してみましょう。

＃＃＃＃　コードレビュー スキル

これは指示のみのスキルです。つまり、メタデータとスキルの指示を含む SKILL.md ファイルを作成するだけで済みます。バグ、スタイルの問題、ベスト プラクティスについてコードの変更をレビューする詳細をエージェントに提供するスキルを作成しましょう。

特定のプロジェクト フォルダ（$HOME/agy2-projects/my-skills-project) など）にいると仮定すると、最初のステップは、スキルを格納するディレクトリをプロジェクト フォルダに作成することです。

mkdir -p .agents/skills/code-review

プロジェクト フォルダ（例: 先ほど作成した .agents/skills/code-review）に、次の内容の SKILL.md ファイルを作成します。

まとめ

できるようになったこと（大枠）

    • Antigravity のインストール
    • 環境の構成
    • エージェントの制御方法

Next Step

例えば、Antigravity を使用してAppを開発したい場合

リファレンス ドキュメント

🐾
NAVIGATOR AI TOOLKIT

マンチカン航海士の知恵袋

マンチカン航海士が記事全文を読んでいるニャ... 🐾