Skip to main content

​
Backlog

ShanoneのBacklog連携では、96個のツールをエージェントに提供します — カタログの中でも最も網羅性の高い連携の一つで、課題・プロジェクト・Wiki・Git/プルリクエストに加え、その周辺の管理機能(チーム、カスタムフィールド、通知、ウォッチ)までカバーしています。

​
はじめに

1

OAuthで接続する

エージェントにBacklogで何か作業をしてもらう(例:「自分のプロジェクトの未対応課題を一覧表示して」)か、Shanoneダッシュボードのインテグレーションから事前に接続します。
2

Backlogのスペースを承認する

Shanoneにアクセスさせたい特定のスペース(サブドメイン)について、BacklogのOAuth承認画面で承認します — BacklogのOAuthは組織単位ではなくスペース単位でスコープされます。
3

リクエストを再試行する

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

​
利用可能なツール

Shanoneは Backlog向けに96個のツールを提供しており、以下のカテゴリに分類されています。
backlog_get_issue, backlog_search_issues, backlog_count_issues, backlog_create_issue, backlog_update_issue, backlog_delete_issue
backlog_get_issue_comments, backlog_add_issue_comment, backlog_update_issue_comment, backlog_delete_issue_comment
backlog_list_projects, backlog_create_project, backlog_get_project, backlog_update_project, backlog_delete_project, backlog_get_project_users, backlog_add_project_user, backlog_remove_project_user, backlog_get_project_admins, backlog_add_project_admin, backlog_remove_project_admin
backlog_get_issue_types, backlog_create_issue_type, backlog_update_issue_type, backlog_delete_issue_type, backlog_get_project_statuses, backlog_create_project_status, backlog_update_project_status, backlog_delete_project_status, backlog_get_custom_fields, backlog_create_custom_field, backlog_update_custom_field, backlog_delete_custom_field, backlog_get_categories, backlog_create_category, backlog_update_category, backlog_delete_category, backlog_get_versions, backlog_create_version, backlog_update_version, backlog_delete_version
backlog_get_wiki_pages, backlog_count_wiki_pages, backlog_get_wiki_tags, backlog_get_wiki_page, backlog_create_wiki_page, backlog_update_wiki_page, backlog_delete_wiki_page, backlog_get_wiki_history, backlog_get_wiki_attachments, backlog_attach_file_to_wiki, backlog_delete_wiki_attachment
backlog_get_git_repositories, backlog_get_git_repository, backlog_get_pull_requests, backlog_count_pull_requests, backlog_create_pull_request, backlog_get_pull_request, backlog_update_pull_request, backlog_get_pull_request_comments, backlog_add_pull_request_comment, backlog_update_pull_request_comment, backlog_get_pull_request_attachments
backlog_get_documents, backlog_get_document_tree, backlog_get_document, backlog_add_document, backlog_delete_document, backlog_download_document_attachment
backlog_get_teams, backlog_create_team, backlog_get_team, backlog_update_team, backlog_delete_team, backlog_get_users, backlog_get_user, backlog_get_myself, backlog_get_recently_viewed_issues, backlog_get_recently_viewed_projects, backlog_get_recently_viewed_wikis, backlog_get_space, backlog_get_space_notification, backlog_get_space_disk_usage
backlog_get_notifications, backlog_count_notifications, backlog_mark_notification_read, backlog_mark_all_notifications_read, backlog_get_watching_list, backlog_count_watching, backlog_add_watching, backlog_update_watching, backlog_delete_watching, backlog_add_star, backlog_remove_star
backlog_get_priorities, backlog_get_resolutions

​
よくある使い方

課題のトリアージ

状態・担当者で課題を検索し、優先度や状態を一括更新する

プルリクエストのレビュー

オープンなプルリクエストとコメントを一覧表示し、フォローアップコメントを追加する

Wikiナレッジベースの維持

Wikiページを作成・更新し、編集履歴を追跡する

リリース計画

バージョン/マイルストーンを作成し、リリース前にそこへ課題を紐づける

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

BacklogのOAuthは接続時に1つのスペース(サブドメイン)にスコープされます — 複数のBacklogスペースを扱う必要がある場合は、それぞれ個別に連携を再接続してください。
課題種別・カテゴリ・カスタムフィールドはすべてプロジェクトごとに異なります。まず対象プロジェクトのbacklog_get_issue_typesやbacklog_get_categoriesで有効なIDを取得してください。
baseとbranchの名前がbacklog_get_git_repositoryにある既存のGitブランチと完全に一致しているか確認してください — Backlogはブランチ名の入力ミスを自動修正しません。