最初のエージェント型ワークフロー

メモ

GitHub エージェント型ワークフロー are in パブリックプレビュー and subject to change.

イントロダクション

GitHub エージェント型ワークフローでは、AI を利用したワークフローを使用してリポジトリタスクを自動化できます。 GitHub エージェント型ワークフローの概要については、GitHub のエージェント型ワークフローについてを参照してください。

このガイドでは、事前に構築されたエージェントワークフロー (毎日のリポジトリ状態レポート) を既存のリポジトリに追加します。これには約 10 分かかり、 GitHub Actionsで実行される自動化されたエージェントの実際の例が示されます。

このクイックスタートでは、最初のワークフローを実行することに重点を置いています。より詳細なセットアップとトラブルシューティングのガイダンスについては、 GitHub エージェント型ワークフロードキュメントサイトを参照してください。

開始する前に、以下の項目があることを確認します:

このクイックスタートは、サポートされている任意のエンジンで完了できます。 GitHub Copilot は既定のエンジンであり、 GitHub Copilot プランは選択したときにのみ必要です。

サポートされているオペレーティングシステムは、Linux、macOS、および WSL を使用したWindowsです。

GitHub エージェント型ワークフローのGitHub CLI拡張機能をインストールします。

gh extension install github/gh-aw

リポジトリのルートから、次のコマンドを実行します。

gh aw add-wizard githubnext/agentics/daily-repo-status

add-wizard コマンドは、ワークフロー参照をOWNER/REPO/WORKFLOW-NAME形式で受け入れます。この対話型プロセスでは、次の処理が行われます。

リポジトリの前提条件を確認します。
AI エンジンを選択するように求めるメッセージが表示されます (既定Copilot 、または他のエンジンから選択します)。
選択したエンジンのシークレットと認証のセットアップについて説明します。選択したエンジンによっては、ウィザードによって、 COPILOT_GITHUB_TOKEN、 ANTHROPIC_API_KEY、 OPENAI_API_KEY、または GEMINI_API_KEYの構成が求められる場合があります。セットアップ手順については、認証リファレンスの記事を参照してください。
ワークフローマークダウンファイルを生成し、対応する .lock.yml ファイルをコンパイルします。
生成された両方のファイルを .github/workflows/に追加する pull request を開きます。
プルリクエストを自分で確認してマージするか、自動でマージされるフローを選択できます。

ワークフローが作成されると、すぐに実行するかどうかを確認するメッセージが表示されます。 [ はい ] を選択してワークフローをトリガーします。

自動化されたワークフローの実行には通常、2 ~ 3 分かかります。完了すると、以下を分析する日次ステータスレポートを含む新しい Issue がリポジトリに作成されます。

優先順位に合わせてワークフローを編集できます。