GitHubをAIエージェントに接続する

想定されるワークフロー

コネクタのアクション

• list_issues (読み取り)

  リポジトリの未解決Issueを一覧表示する。

• get_pull_request (読み取り)

  プルリクエストの詳細を確認する。

• list_workflow_runs (読み取り)

  Actionsワークフローの最近の実行を一覧表示する。

• get_workflow_run (読み取り)

  ワークフロー実行の詳細を確認する。

• get_job_logs_download_url (読み取り)

  ジョブのログのURLを取得する。

• list_releases (読み取り)

  すでに公開されているリリースを一覧表示する。

• create_label (書き込み)

  リポジトリに新しいラベルを作成する。

• update_issue (書き込み)

  Issueを変更する:ラベル、ステータス、アサイン。

• add_issue_comment (書き込み)

  Issueにコメントを追加する。

• create_branch (書き込み)

  参照元からブランチを作成する。

• create_or_update_file (書き込み)

  コミットメッセージ付きでファイルを作成または変更する。

• create_pull_request (書き込み)

  あるブランチから別のブランチへプルリクエストを開く。

• create_review_request (書き込み)

  一人または複数のレビュアーにレビューを依頼する。

• create_release (書き込み)

  タグとノートを添えてリリースを公開する。

前提条件

• 対象リポジトリへの書き込みアクセス権を持つGitHubアカウント。
• Settings、Developer settings、Personal access tokensから発行するfine-grainedトークン。
• Contents、Issues、Pull requestsの権限をRead and writeに、ActionsをReadに設定。
• Atakoの設定、連携からトークンを貼り付ける。
• エージェント、接続、具体的なアクションと範囲を指定する明示的なgrant。

接続方法

1. 1

   GitHubでfine-grainedトークンを生成する

   Settings、Developer settings、Personal access tokens、Fine-grained tokens、Generate new tokenの順に進む。Contents、Issues、Pull requestsを書き込み、Actionsを読み取りでチェックし、表示されたトークンをコピーする。

2. 2

   トークンをAtakoに接続する

   設定、連携にトークンを貼り付ける。この接続はすべてのエージェントで利用可能になる。

3. 3

   エージェントにgrantを付与する

   エージェントのページから、具体的なGitHubアクションとその範囲を選択する。デフォルトはdeny-by-defaultで、何もアクセスできない状態から始まる。

4. 4

   最初のシナリオを実行する

   付与されたgrantに応じて、エージェントはIssueを一覧表示したり、プルリクエストを開いたり、CI実行を監視したりし、人間の判断が必要になればアラートを出す。