{"meta":{"title":"最初のエージェント型ワークフロー","intro":"事前構築済みのワークフローと GitHub CLI を使用して、初めての AI を利用した自動化を実行します。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/copilot","title":"GitHub Copilot"},{"href":"/ja/copilot/how-tos","title":"方法"},{"href":"/ja/copilot/how-tos/github-agentic-workflows","title":"GitHub エージェント型ワークフロー"},{"href":"/ja/copilot/how-tos/github-agentic-workflows/quickstart","title":"クイック スタート"}],"documentType":"article"},"body":"# 最初のエージェント型ワークフロー\n\n事前構築済みのワークフローと GitHub CLI を使用して、初めての AI を利用した自動化を実行します。\n\n> \\[!NOTE]\n> GitHub エージェント型ワークフロー are in パブリック プレビュー and subject to change.\n\n## イントロダクション\n\nGitHub エージェント型ワークフロー では、AI を利用したワークフローを使用してリポジトリ タスクを自動化できます。\nGitHub エージェント型ワークフローの概要については、[GitHub のエージェント型ワークフローについて](/ja/copilot/concepts/agents/about-github-agentic-workflows) を参照してください。\n\nこのガイドでは、事前に構築されたエージェント ワークフロー (毎日のリポジトリ状態レポート) を既存のリポジトリに追加します。 これには約 10 分かかり、 GitHub Actionsで実行される自動化されたエージェントの実際の例が示されます。\n\nこのクイック スタートでは、最初のワークフローを実行することに重点を置いています。 より詳細なセットアップとトラブルシューティングのガイダンスについては、 [GitHub エージェント型ワークフロー ドキュメント サイト](https://github.github.com/gh-aw/)を参照してください。\n\n## 前提条件\n\n開始する前に、以下の項目があることを確認します:\n\n* AI アカウント: GitHub Copilot、 Anthropic Claude、 OpenAI Codex、Google Gemini\n* 書き込みアクセス権がある GitHub リポジトリ\n* GitHub Actions リポジトリに対して有効\n* GitHub CLI (`gh`) v2.0.0 以降がインストールおよび認証されている\n\n  バージョンを確認するには、 `gh --version`を実行します。 認証するには、次のコマンドを実行します。\n\n  ```shell\n  gh auth login --scopes repo,workflow\n  ```\n\nこのクイック スタートは、サポートされている任意のエンジンで完了できます。\nGitHub Copilot は既定のエンジンであり、 GitHub Copilot プランは選択したときにのみ必要です。\n\nサポートされているオペレーティング システムは、Linux、macOS、および WSL を使用したWindowsです。\n\n## 手順 1: `gh aw` 拡張機能をインストールする\n\nGitHub エージェント型ワークフローのGitHub CLI拡張機能をインストールします。\n\n```shell\ngh extension install github/gh-aw\n```\n\n## 手順 2: ワークフローを追加して実行をトリガーする\n\nリポジトリのルートから、次のコマンドを実行します。\n\n```shell\ngh aw add-wizard githubnext/agentics/daily-repo-status\n```\n\n`add-wizard` コマンドは、ワークフロー参照を`OWNER/REPO/WORKFLOW-NAME`形式で受け入れます。 この対話型プロセスでは、次の処理が行われます。\n\n1. リポジトリの前提条件を確認します。\n2. AI エンジンを選択するように求めるメッセージが表示されます (既定Copilot 、または他のエンジンから選択します)。\n3. 選択したエンジンのシークレットと認証のセットアップについて説明します。 選択したエンジンによっては、ウィザードによって、 `COPILOT_GITHUB_TOKEN`、 `ANTHROPIC_API_KEY`、 `OPENAI_API_KEY`、または `GEMINI_API_KEY`の構成が求められる場合があります。 セットアップ手順については、 [認証リファレンス](https://github.github.com/gh-aw/reference/auth/) の記事を参照してください。\n4. ワークフロー マークダウン ファイルを生成し、対応する `.lock.yml` ファイルをコンパイルします。\n5. 生成された両方のファイルを `.github/workflows/`に追加する pull request を開きます。\n6. プル リクエストを自分で確認してマージするか、自動でマージされるフローを選択できます。\n\nワークフローが作成されると、すぐに実行するかどうかを確認するメッセージが表示されます。 \\[ **はい** ] を選択してワークフローをトリガーします。\n\n## 手順 3: ワークフローが完了するまで待つ\n\n自動化されたワークフローの実行には通常、2 \\~ 3 分かかります。 完了すると、以下を分析する日次ステータス レポートを含む新しい Issue がリポジトリに作成されます。\n\n* 最近のリポジトリ アクティビティ (問題、プル要求、ディスカッション、リリース)\n* 進行状況の追跡と強調表示\n* 保守担当者向けの実行可能な次の手順\n\n## 手順 4: ワークフローをカスタマイズする (省略可能)\n\n優先順位に合わせてワークフローを編集できます。\n\n1. リポジトリで `.github/workflows/daily-repo-status.md` を開きます。\n\n2. マークダウン本文を編集して、問題のバックログ、CI のセットアップ、テスト、パフォーマンス、ロードマップなど、レポートの内容を説明します。\n\n3. frontmatter 構成を変更した場合は、ワークフローを再コンパイルします。\n\n   ```shell\n   gh aw compile\n   ```\n\n4. 変更をコミットしてプッシュしてください。\n\n5. 必要に応じて、別の実行をトリガーします。\n\n   ```shell\n   gh aw run daily-repo-status\n   ```\n\n## 次のステップ\n\n* 独自のカスタム エージェント型ワークフローを作成するには、 [GitHubのエージェント型ワークフローの作成](/ja/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows) を参照してください。\n* 高度なパターンと完全なリファレンスについては、 [GitHub エージェント型ワークフロー ドキュメント サイト](https://github.github.com/gh-aw/)を参照してください。"}