GitHub Issues統合
対応: GitHub
ReplyRabbit を GitHub Issues に接続し、FreeScout のサポート会話を適切なリポジトリの構造化された Issue に変換できるようにします。エージェントは会話から Issue を作成し、リンクされた Issue を FreeScout で表示したままにし、ReplyRabbit にエンジニアリングハンドオフを準備させることができます。
概要をお探しですか?
概要
GitHub Issues 統合は、FreeScout 会話の ReplyRabbit に GitHub パネルを追加します。GitHub が設定されている場合、ReplyRabbit は開発者に優しいタイトル、有用な要約、ラベル、担当者、リポジトリコンテキスト、サポート会話へのリンクを含む課題を作成できます。
各メールボックスは1つの課題トラッカーを選択します: なし、Linear、またはGitHub。GitHubとLinearは同じサポートからエンジニアリングへのワークフローの代替手段であり、1つのメールボックスで一緒に実行される2つのトラッカーではありません。
手動のGitHub課題作成はProおよびTeamで利用可能です。新しい顧客メールからの自動GitHub課題作成はTeamで利用可能です。
前提条件
始める前に、次を確認してください:
- 動作するFreeScoutインストール。
- ReplyRabbitがインストールされ、有効化されています。
- 使用したいGitHub機能を含むReplyRabbitプラン。
- イシューを作成するGitHubアカウントまたは組織へのアクセス。
- GitHub Issuesが有効なリポジトリ。
ReplyRabbitがまだインストールされていない場合は、次から始めてください ReplyRabbitモジュールのインストール方法)、次に完了します ReplyRabbitのセットアップ方法.
権限とトークンスコープ
ReplyRabbitは、メールボックス設定で提供する個人アクセストークンを使用してGitHubに接続します。きめ細かいトークンを使用し、ReplyRabbitが使用すべきリポジトリに限定することをお勧めします。次の場所から作成できます GitHubのきめ細かいトークン設定.
リポジトリメタデータの読み取り、ラベルと担当者の読み取り、課題の作成と更新、課題コメントの追加に十分なアクセス権をトークンに付与します。きめ細かいトークンの場合は、次から始めます メタデータ: 読み取り, 内容: 読み取り)、および 課題:読み取りと書き込み 選択したリポジトリ用。
より厳格な監査証跡のために、ReplyRabbitが使用すべきリポジトリにのみアクセスできる専用のGitHubボットアカウントからトークンを作成してください。
トークンは非公開に保ってください。GitHubでトークンがローテーションまたは削除された場合は、さらに課題を作成する前にメールボックス設定を更新してください。
GitHub Issues を接続
メールボックス設定を開く
FreeScoutでGitHub issueを作成するメールボックスを開き、次を開いてください 設定 そして選択 ReplyRabbit.課題トラッカーとしてGitHubを選択
issueトラッカーセレクターで次を選択してください GitHub Issues)。ReplyRabbitはそのメールボックスのGitHub設定を表示し、Linear設定を非表示にします。トークンを貼り付けます
次を貼り付けます GitHub Personal Access Token)。すでにトークンを保存している場合、ReplyRabbitは完全なシークレットの代わりにマスクされたプレビューを表示します。リポジトリを読み込む
ボタンをクリックしてGitHubからリポジトリを読み込み、新しい課題を作成するデフォルトリポジトリを選択してください。設定を保存
メールボックス設定を保存します。ReplyRabbitはそのメールボックスのGitHub接続を保存します。
デフォルトを設定
デフォルトリポジトリが選択されたら、エージェントが開始するイシューのデフォルトを設定します:
- デフォルトリポジトリ: ルーティングルールが一致しない場合に課題が作成される場所を選択します。
- issue を自動送信: Teamティアで、トリアージ結果がエンジニアリング作業が必要と示した場合に、ReplyRabbitがGitHubイシューを自動的に作成できるようにします。
- リポジトリルーティング: ReplyRabbitが会話を利用可能なリポジトリにマッチングさせる場合は、自動リポジトリ選択を有効にします。
- ドメインマッピング: 決定論的なルーティングが必要な場合、顧客メールドメインを特定のリポジトリにマップします。
- ラベル: 課題タイプ、優先度、またはその他のワークフロータグに対してReplyRabbitが適用できるラベルを選択します。
- 優先度ラベル: ReplyRabbitの優先度レベルをGitHubラベルにマップします。GitHub Issuesにはネイティブの優先度フィールドがないためです。
- デフォルト担当者: 新しい課題をデフォルトで受け取るGitHubユーザーを選択します。
- レビュー通知: 自動課題作成が有効な場合、課題が自動的に作成されたことと確認が必要であることをエージェントに伝える FreeScout のメモを追加します。
リポジトリルーティングはオプションです。リポジトリが確実に一致しない場合、ReplyRabbitはデフォルトのリポジトリを使用します。
FreeScout の会話から GitHub Issue を作成
GitHubが設定されているメールボックスで会話を開きます。ReplyRabbitパネルは顧客スレッドからGitHub issueを作成し、リンクされたissueをFreeScoutに表示できます。
課題の内容はエンジニアリングハンドオフ用に生成され、メールスレッド全体から盲目的にコピーされたものではありません。手動作成を使用する場合は、課題を作成する前にタイトル、要約、ラベル、担当者、リポジトリを確認してください。
ReplyRabbitはメールスレッドのコンテキストをGitHub issueのコメントとして追加することもできるため、サポートに同じスレッドの貼り付けを依頼することなく、エンジニアリング側が顧客の詳細を把握できます。
会話と課題を同期させ続ける
課題がリンクされると、FreeScout の会話に現在の GitHub 課題の識別子、タイトル、状態、ラベル、担当者が表示されます。エージェントは完全なエンジニアリングビューが必要なときに GitHub で課題を開くことができます。
ReplyRabbitは完了ループもサポートします: リンクされたGitHub issueをスケジュール (通常5分ごと) でチェックします。GitHubがissueをクローズすると、ReplyRabbitはサポートがコンテキストとともに会話をクローズできるよう、顧客フォローの下書き作成を支援できます。チームがGitHubのクローズ理由を使用している場合、completedとしてクローズされたissueに完了下書きを限定できます。
トラブルシューティング
| 症状 | 確認すべきこと |
|---|---|
| リポジトリが読み込まれません | トークンが最新で、選択した GitHub リポジトリにアクセスできることを確認してください。 |
| 課題が作成されない | GitHubが選択された課題トラッカーであり、デフォルトリポジトリが選択され、ReplyRabbitプランにこの機能が含まれていることを確認してください。 |
| 自動 issue は作成されません | Team ティアを使用していること、および issue を自動送信 が有効です。 |
| リポジトリが間違っているか見つかりません | リポジトリルーティングまたはドメインマッピングが設定されていることを確認してください。確実な一致がない場合、ReplyRabbitはデフォルトリポジトリを使用します。 |
| ラベルまたは担当者が更新されない | 会話を再読み込みし、トークンがリンクされたリポジトリへのアクセスをまだ持っていることを確認してください。 |
| GitHubがレート制限エラーを返す | トークンのGitHub API制限がリセットされるのを待ち、その後リポジトリアクセスの絞り込みや自動課題アクティビティの削減を検討してください。 |
| クローズされた課題は下書きを生成しません | 確認 Done 時の自動下書き が有効で、完了のみモードがオンの場合、GitHubイシューが完了としてクローズされた。 |
より広範な修正については、次を参照してください ReplyRabbitのトラブルシューティング.
プライバシーとデータの取り扱い
ReplyRabbitはエンジニアリングへの引き継ぎに必要な課題コンテンツをGitHubに送信します。これには関連する顧客コンテキスト、生成された課題タイトル、生成された要約、ラベル、担当者、FreeScoutの会話リンクまたは識別子が含まれる場合があります。
リポジトリが受け取ることが許可されていない限り、GitHub issueに機密情報を入れないでください。顧客データを完全に自分のサーバーに留める必要がある場合は、そのメールボックスでGitHubを無効にしておいてください。
次のステップ
- 次で続行 ReplyRabbitのセットアップ方法 メールボックスにまだプロバイダー、コンテキスト、またはスタイル設定が必要な場合。
- 読み取り Slack連携 チームがSlackでイシュー作成または完了通知を希望する場合。
- 次と比較 Linear統合 メールボックスがどのイシュートラッカーを使用すべきか決定している場合。
FAQ
GitHubのパーソナルアクセストークンは必要ですか?
はい。ReplyRabbitはあなた自身のGitHubアカウントまたは組織のトークンでGitHubに接続します。
1つのメールボックスでLinearとGitHubを同時に使用できますか?
いいえ。各メールボックスは1つのイシュートラッカーを選択します: なし、Linear、または GitHub。
ReplyRabbit は GitHub リポジトリを選択できますか?
はい、リポジトリルーティングが構成されている場合に可能です。ReplyRabbitはドメインマッピングと、トークンがアクセスできるリポジトリに対するAIリポジトリマッチングをサポートしています。
GitHub Issuesを含むプランはどれですか?
手動のGitHub課題作成はPro機能です。自動のGitHub課題作成はTeam機能です。
ReplyRabbitは顧客との会話全体をGitHubに送信しますか?
ReplyRabbitは、関連する顧客コンテキストと生成された要約を含む、エンジニアリングへの引き継ぎに必要な課題コンテンツを送信します。