“GitHubサンプル”ボットはアプリをGitHubに登録し、認証トークンを生成し、それらのトークンをボットビルダーのボットに追加するための基本構成を含んでいます。構成後、ボットと会話機能を使用してボットをテストし、次の構成済みアラートおよびアクションのいずれかをテストできます。

  • アラートタスク
    • 更新をコミット
    • 作成された問題
    • プルリクエスト通知
  • アクションタスク
    • プルリクエストの作成
    • コメントの問題
    • 問題を作成する

GitHubサンプルボットのインストール

“GitHubサンプル”ボットはボットビルダーでのみ利用可能であり、新しいボットとして追加する必要があります。一部のボット機能をデモするために特別に構成された限定的な設計です。

メモ：このサンプルボットはKore.aiボットストアで入手できるGitHubの組み込みボットと似ていますが、同じではありません。

ステップ 1：GitHubサンプルボットのインストール

  1. サンプルボットを表示するには、新しいボット追加の横にある下向き矢印をクリックし、サンプルボットのインストールを選択します。
  2. “GitHubサンプル”ボットにカーソルを合わせ、インストールボタンをクリックします。
  3. GitHubサンプルページの手順タブで、コールバックURL、https：//idp.kore.ai/workflows/callbackをメモしてください。後でGitHubアプリの登録に貼り付ける必要があります。

ステップ 2：GitHubアプリを登録します

  1. Githubアプリを登録するには、https：//github.com/settings/developersでGitHubにログオンします。
  2. 左側のナビゲーションメニューでOAuthアプリケーションを選択し、新しいアプリケーションの登録をクリックします。
  3. アプリケーション名フィールドに、GitHubアプリの名前My GitHub Appなどを入力します。
  4. 必要に応じて、ホームページのURLとアプリケーションの説明を追加します。
  5. 次のイラストに示すように、ボットビルダーからコピーしたURLhttps：//idp.kore.ai/workflows/callbackを認証コールバックURLフィールドに貼り付けます。
  6. アプリケーションの登録をクリックします。次のイラストに示すように、<My GitHub App name>ページがクライアントの資格情報とともに表示されます。
  7. GitHubクライアントID とクライアントシークレットの詳細をコピーします。
  8. ボットビルダーのサンプルボットインストールページに戻ります。
  9. 上記の値を構成タブのクライアントIDフィールドとクライアントシークレットフィールドにコピーし、完了をクリックします。
  10. “GitHubサンプルが正常にインストールされました”というメッセージが表示されます。

ステップ 3：ボットの承認

  1. ボットビルダーホームページでボットを選択し、ボットと会話アイコンをクリックして“GitHubサンプル”ボットをテストします。
  2. 最初にボットを使用する際、Kore.aiにGitHubレポジトリへのアクセスを許可するためのリンクが表示されます。
  3. リンクをクリックして、GitHubを使用するユーザーのワンタイム認証を完了します。

ステップ 4：サンプルボットのカスタマイズ

ボットと会話を使用してボットを試し、すべてのアラートとアクションをテストします。次に、ボットビルダーでボットの「構成」タブを確認します。ボットタスク―タスクを追加または変更します。このボットは、3つのアラートタスクと3つのアクションタスクで構成されています。ダイアログタスク、情報タスク、ナレッジタスクを追加し、フローを構成することもできます。自然言語を詳細―ボットの自然言語処理と機械語の理解をレビューして最適化します。詳細。チャネル – いくつかの通信チャネルに対してこのボットを有効にします。このボットは、デフォルトでKoreチャネルに対して有効になっています。詳細はこちら。設定―名前、アイコン、その他の設定などのボット設定を編集または定義します。詳細はこちら。公開―エンタープライズの標準ボットまたはKore.aiボットストアのアラート、アクション、またはダイアログタスクを公開できます。詳細については、タスクの公開を参照してください。分析―チャット履歴を使用して、ボットプラットフォームとユーザー間の会話をすべて確認できます。詳細については、チャットログセクションでボットとユーザー間の成功したインタラクションと失敗したインタラクションの両方を確認および分析できます。必要に応じて、インタラクションに基づいてボットトレーニングを開始し、将来のコミュニケーショントランザクションをより適切に処理できます。詳細については、ボットの分析を参照してください。

GitHub 샘플 봇은 GitHub으로 앱을 등록하는 기본 설정, 인증 토큰 생성, 그리고 이러한 토큰을 봇 빌더의 봇에 추가하는 것을 포함합니다. 설정 후에, 봇과 대화 기능을 사용하여 다음 설정된 알림 및 조치를 테스트할 수 있습니다.

  • 경고 작업
    • 커밋 업데이트
    • 이슈 생성됨
    • 풀 요청 알림
  • 조치 작업
    • 풀 요청 생성
    • 이슈 코멘트
    • 이슈 생성

GitHub 샘플 봇 설치

GitHub 샘플 봇은 봇 빌더에서만 사용할 수 있으며 새 봇으로 추가되어야 합니다. 이 봇은 특정 봇 기능을 설정하기 위해 특별히 설정된 한정적으로 설계되었습니다.

참고: 이 샘플 봇은 Kore.ai 봇 스토어에서 이용할 수 있는 GitHub의 내장 봇과 유사하지만 같지 않습니다.

1단계: GitHub 샘플 봇 설치

  1. 샘플 봇을 보려면, +새 봇 옆의 아래 화살표를 클릭하고 샘플 봇 설치를 선택합니다.
  2. GitHub 샘플 봇으로 마우스를 이동한 다음 설치 버튼을 클릭합니다.
  3. GitHub 샘플 페이지의 지시 사항 탭에서, 콜백 URL인https://idp.kore.ai/workflows/callback을 기록합니다. 추후에 GitHub 앱 등록에 붙여넣어야 합니다.

2단계: GitHub 앱 등록

  1. GitHub 앱을 등록하려면, https://github.com/settings/developers에서 GitHub에 로그인하세요.
  2. 왼쪽 탐색 메뉴에서 OAuth 애플리케이션을 선택한 다음 새 애플리케이션 등록을 클릭합니다.
  3. 애플리케이션 이름 필드에서, GitHub 앱의 이름을 입력합니다. 예를 들면, 내 GitHub 앱입니다.
  4. 선택적으로 홈페이지 URL 및 애플리케이션 설명을 추가합니다.
  5. 봇 빌더에서 복사된 URL인 https://idp.kore.ai/workflows/callback을 인증 콜백 URL 필드에 다음 그림에 나타난 대로 붙여넣습니다.
  6. 애플리케이션 등록을 클릭합니다 클라이언트 인증 정보와 함께 다음 그림에 나타난 대로 <내 GitHub 앱 이름> 페이지가 나타납니다.
  7. GitHub 클라이언트 ID와 클라이언트 시크릿 을 복사합니다.
  8. 봇 빌더, 샘플 봇 설치 페이지로 돌아갑니다.
  9. 위의 값을 설정 탭의 ClientID 및 ClientSecret 필드에 붙여넣은 다음 마침을 클릭합니다.
  10. 성공적으로 GitHub 샘플 설치됨 메시지가 표시됩니다.

3단계: 봇 권한 부여

  1. 봇 빌더 홈 페이지에서 봇을 선택한 다음 봇과 대화 아이콘을 클릭하여 GitHub 샘플 봇을 테스트합니다.
  2. GitHub 저장소에 Kore.ai가 액세스하도록 권한을 부여하는 링크가 봇을 처음으로 사용 시 표시됩니다.
  3. 링크를 클릭하고 GitHub로 사용자에 대한 일회성 권한 부여를 마칩니다.

4단계: 샘플 봇 커스터마이징

봇과 대화를 사용하여 봇을 체험하고 모든 알림과 조치를 테스트합니다. 그런 다음 봇 빌더의 봇 설정 탭을 검토합니다.

봇 작업 – 작업을 추가하거나 수정합니다. 이 봇은 3개의 알림 작업과 3개의 조치 작업으로 구성되어 있습니다. 대화 작업, 정보 작업, 지식 작업, 설정 흐름도 추가할 수 있습니다.

자연어 더 알아보기 – 봇의 자연어 처리와 기계어 이해에 대해 검토하고 최적화합니다. 더 알아보기.

채널 – 한 개 이상의 통신 채널에 대해 해당 봇을 활성화합니다. 이 봇은 기본값으로 Kore 채널에 활성화되어 있습니다. 더 알아보기.

설정 – 봇 설정을 편집하거나 정의합니다. 예를 들면 이름, 아이콘 및 기타 설정입니다. 더 알아보기.

게시 – 기업용 표준 봇에 알림, 조치, 또는 대화 작업을 게시하거나 Kore.ai 봇 스토어에 게시할 수 있습니다. 자세한 정보는 작업 게시하기를 참조하세요.

분석 – 채팅 기록을 사용하여 봇 플랫폼과 사용자 사이의 전체 대화를 검토할 수 있습니다. 더 자세하게 말하자면,

채팅 로그 섹션에서 봇과 사용자 사이의 성공적이거나 성공적이지 못한 상호작용 모두를 검토하고 분석할 수 있습니다. 필요하다면 인터렉션에 따라 향후 통신 교류가 더 나아지도록 봇 훈련을 시작할 수 있습니다. 자세한 정보는 봇 분석하기를 참조하세요.

The GitHub Sample bot contains the basic configuration for registering an app with GitHub, generating authentication tokens, and then adding those tokens to the bot in Bot Builder. After configuration, you can test the bot using the Talk to Bot feature to test any of the following configured alerts and actions.

  • Alert Tasks
    • Commit update
    • Issue created
    • Pull Request Notification
  • Action Tasks
    • Create Pull Request
    • Comment Issue
    • Create Issue

Installing the GitHub Sample Bot

The GitHub Sample Bot is only available in Bot Builder and must be added as a new bot. It has a limited design specifically configured to demonstrate certain bot features.

Note: This sample bot is similar but not the same as the built-in bot for GitHub available at the Kore.ai Bot Store.

Step 1: Install the GitHub Sample Bot

  1. To view your sample bots, click the down-arrow next to the  +New Bot and select Install Sample Bots.
  2. Hover over the GitHub Sample bot, and then click the Install button.
  3. On the GitHub Sample page, on the Instructions tab, note the callback URL https://idp.kore.ai/workflows/callback.  You need to paste into your Github App registration later.

Step 2: Register your GitHub App

  1. To register your Github App, log on to GitHub at https://github.com/settings/developers.
  2. Select OAuth applications on the lefthand navigation menu, and then click Register a new application.
  3. In the Application name field, enter the name of your GitHub App, for example, My GitHub App.
  4. Optionally, add a Homepage URL and Application description.
  5. Paste the URL copied from Bot Builder, https://idp.kore.ai/workflows/callback, into the Authorization callback URL field as shown in the following illustration.
  6. Click Register application. The < My GitHub App name > page is displayed as shown in the following illustration with client credentials.
  7. Copy the GitHub Client ID and Client Secret
  8. Go back to the Bot Builder, Sample Bot Installation page.
  9. Copy the above values into the ClientID and ClientSecret fields on the Configuration tab, and click Done.
  10. The GitHub Sample successfully installed message is displayed.

Step 3: Authorize the Bot

  1. From the Bot Builder Home page, select your bot, and then click the Talk to Bot  icon to test the GitHub Sample bot.
  2. A link to authorize Kore.ai to access your GitHub repository is displayed on first use of the bot.
  3. Click the link, and then complete a one-time authorization for the user with GitHub.

Step 4: Customizing the Sample Bot

Try out your bot using Talk to Bot and test all the alerts and actions. Then review the configuration tabs of the bot in Bot Builder:

Bot Tasks – Add or modify tasks. This bot is configured with 3 alert tasks and 3 actions task. You can also add dialog tasks, information tasks, knowledge tasks, and configure flows. Know more

Natural Language – Review and optimize natural language processing and machine language understanding of your bot. Know more.

Channels – Enable this bot for one or more communication channels. This bot is enabled for the Kore channel by default. Know more.

Settings – Edit or define bot settings, such as name, icon, and other settings. Know more.

Publishing – You can publish alert, action, or dialog tasks for Standard Bots for an enterprise or to the Kore.ai Bot Store. For more information, see Publishing Tasks.

Analyze – You can review the full conversation between the Bots Platform and a user using Chat History. For more detail, you can review and analyze both successful, and unsuccessful interactions between a Bot and a user in the Chat Logs section. If necessary, based on the interaction, you can initiate Bot training to better handle future communication transactions. For more information, see Analyzing Your Bot.