Skip to main content

​
Jira

ShanoneのJira連携では、Jira Cloudのプロジェクト管理機能——課題、プロジェクト、ボード、スプリント、作業ログ、ダッシュボード、フィルタなどを扱う47のツールをエージェントが利用できるようになります。複数サイトを持つAtlassianアカウントにも対応しています。

​
はじめに

1

OAuthで接続する

エージェントにJiraで何か作業をしてもらう(例:「ログイン問題のバグチケットを作成して」)か、ShanoneダッシュボードのIntegrationsから事前に接続します。
2

Atlassianアカウントを認可する

AtlassianのOAuth同意画面を承認し、ShanoneがアクセスすべきJiraサイト(クラウドインスタンス)を選択します。
3

リクエストを再試行する

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

​
利用可能なツール

ShanoneはJira用に47のツールを提供しており、以下のカテゴリに分類されています。
jira_get_issue, jira_search_issues, jira_create_issue, jira_update_issue, jira_delete_issue, jira_bulk_create_issues
jira_list_projects, jira_get_project, jira_get_issue_types, jira_create_project, jira_get_recent_projects, jira_get_project_components
jira_get_comments, jira_add_comment, jira_update_comment, jira_delete_comment
jira_list_boards, jira_create_board, jira_get_board_issues, jira_list_sprints, jira_create_sprint, jira_get_sprint, jira_move_issues_to_sprint
jira_get_transitions, jira_transition_issue, jira_search_users, jira_assign_issue
jira_create_issue_link, jira_get_issue_link_types, jira_get_issue_watchers, jira_add_watcher, jira_remove_watcher
jira_add_worklog, jira_get_worklogs, jira_update_worklog, jira_delete_worklog
jira_add_attachment, jira_get_attachment_meta, jira_delete_attachment
jira_create_version, jira_get_project_versions, jira_delete_version
jira_get_dashboards, jira_search_dashboards, jira_list_filters, jira_get_filter, jira_get_favorite_filters

​
よくある使い方

バグトリアージ

バグレポートから課題を作成・トリアージし、適切なプロジェクトとスプリントに割り当てる

スプリント計画

複数の課題を次のスプリントに移動し、スタンドアップ前にボードの状態を確認する

作業時間の集計

複数の課題の作業ログを取得し、プロジェクトやエピックにかかった時間を要約する

課題間のリンク

調査中に見つかった関連課題を(ブロック、重複、関連あり等で)リンクする

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

Jiraのプロジェクトごとに必須フィールド(カスタムフィールドやコンポーネントなど)は異なります——デフォルトのTask/Bug/Story以外の課題タイプでは特に、作成前にjira_get_projectとjira_get_issue_typesで何が必須かを確認してください。
利用可能な遷移は課題の現在のステータスとプロジェクトのワークフローに依存します——ステータス名が直接遷移に対応すると仮定せず、まずjira_get_transitionsで課題の現在の状態から利用可能な正確な遷移IDを取得してください。
Jira Cloudのアカウントは複数のサイト(cloud_id)を持つことがあります——複数のJiraサイトにアクセス権がある場合、OAuth接続が目的のプロジェクトを含むサイトにスコープされているか確認してください。必要であればIntegrationsから再接続して別のサイトを選択してください。