Skip to main content

​
GitHub

ShanoneのGitHub連携では、日常的なIssue・PRのワークフローからCI/CD、コード/シークレットスキャン、組織管理、gistまで、176のツールをエージェントが利用できるようになります。

​
はじめに

1

OAuthで接続する

エージェントにGitHubで何か作業をしてもらう(例:「my-org/my-repoのオープンなPRを一覧表示して」)か、ShanoneダッシュボードのIntegrationsから事前に接続します。
2

リクエストされたスコープを承認する

GitHubのOAuth承認画面には、Shanoneがリクエストするスコープ(リポジトリへのアクセス、組織の読み取りなど)が表示されます——内容を確認して承認してください。
3

リクエストを再試行する

接続が完了すると、github_*ツールに対するエージェントのshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはGitHub用に176のツールを提供しており、以下のカテゴリに分類されています。
github_create_issue, github_get_issue, github_update_issue, github_list_issues, github_create_issue_comment, github_list_pr_comments (issue comments), github_create_label, github_update_label, github_delete_label, github_list_labels, github_get_label, github_create_milestone, github_update_milestone, github_delete_milestone, github_list_milestones, github_get_milestone
github_create_pull_request, github_get_pull_request, github_update_pull_request, github_list_pull_requests, github_merge_pull_request, github_list_pr_files, github_create_pr_comment, github_list_pr_comments, github_create_pr_review, github_submit_pr_review, github_get_pr_review, github_list_pr_reviews, github_request_reviewers, github_list_requested_reviewers
github_get_content, github_create_or_update_file, github_delete_file, github_get_readme, github_list_branches, github_get_branch, github_create_branch, github_rename_branch, github_delete_branch, github_compare_commits, github_list_commits, github_get_commit, github_create_commit_comment, github_list_commit_comments
github_create_repo, github_get_repo, github_list_repos, github_list_org_repos, github_get_org, github_list_org_members, github_star_repo, github_unstar_repo, github_list_stargazers, github_list_contributors, github_list_languages, github_list_tags, github_get_authenticated_user, github_list_user_orgs
github_list_workflows, github_trigger_workflow, github_list_workflow_runs, github_get_workflow_run, github_cancel_workflow_run, github_rerun_workflow, github_rerun_workflow_failed_jobs, github_list_workflow_jobs, github_get_workflow_job, github_get_workflow_job_logs, github_list_workflow_artifacts, github_get_artifact, github_delete_artifact, github_get_archive_link
github_create_check_run, github_update_check_run, github_get_check_run, github_list_check_runs_for_ref, github_rerequest_check_run, github_create_check_suite, github_get_check_suite, github_list_check_suites_for_ref, github_rerequest_check_suite, github_create_deployment, github_get_deployment, github_list_deployments, github_create_deployment_status, github_get_deployment_status, github_list_deployment_statuses, github_delete_deployment, github_list_deployment_branch_policies
github_list_code_scanning_alerts, github_get_code_scanning_alert, github_update_code_scanning_alert, github_list_code_scanning_alert_instances, github_list_code_scanning_analyses, github_get_code_scanning_analysis, github_list_dependabot_alerts, github_get_dependabot_alert, github_update_dependabot_alert, github_list_org_dependabot_alerts, github_list_secret_scanning_alerts, github_get_secret_scanning_alert, github_update_secret_scanning_alert, github_list_secret_scanning_alert_locations, github_list_repo_security_advisories, github_get_repo_security_advisory, github_create_or_update_repo_secret, github_delete_repo_secret, github_list_repo_secrets, github_get_repo_secret, github_get_repo_public_key, github_create_or_update_org_secret, github_delete_org_secret, github_list_org_secrets, github_get_org_secret, github_get_org_public_key
github_create_repo_variable, github_update_repo_variable, github_delete_repo_variable, github_list_repo_variables, github_get_repo_variable, github_create_org_variable, github_update_org_variable, github_delete_org_variable, github_list_org_variables, github_get_org_variable, github_create_repo_webhook, github_update_repo_webhook, github_delete_repo_webhook, github_list_repo_webhooks, github_get_repo_webhook, github_ping_repo_webhook, github_test_repo_webhook, github_list_webhook_deliveries, github_get_team, github_list_teams, github_list_team_members, github_list_team_repos
github_create_discussion, github_update_discussion, github_delete_discussion, github_get_discussion, github_list_discussions, github_list_discussion_categories, github_create_discussion_comment, github_list_discussion_comments, github_create_gist, github_update_gist, github_delete_gist, github_get_gist, github_list_gists, github_star_gist, github_unstar_gist, github_fork_gist, github_list_public_gists, github_list_notifications, github_mark_notifications_read, github_mark_thread_read
github_search_code, github_search_issues, github_search_repos, github_create_release, github_update_release, github_delete_release, github_get_release, github_get_latest_release, github_list_releases, github_list_release_assets, github_delete_release_asset

​
よくある使い方

Issueトリアージ

自然言語のリクエストからIssueを検索し、ラベル付けし、コメントする

PRレビューの自動化

オープンなPRを一覧表示し、差分を取得し、レビューを提出する

CI/CD制御

ワークフローをトリガーし、実行ログを確認し、失敗したジョブを再実行する

セキュリティ監視

オープンなDependabot、コードスキャン、シークレットスキャンのアラートを可視化する

​
トラブルシューティング

組織スコープのツール(github_list_org_secrets、github_get_orgなど)を使うには、接続済みアカウントが適切な組織ロールを持っている必要があります。これらが失敗する場合は、管理者権限を持つアカウントで再接続してください。
ワークフローファイルが実際にworkflow_dispatchトリガーを宣言しているか確認してください——github_trigger_workflowはこのトリガーをサポートするワークフローのみ開始できます。
GitHubは仕様上、APIを通じてシークレットの値を返しません——github_get_repo_secretなどはメタデータ(名前、タイムスタンプ)のみを返し、平文の値は返しません。