GitHub Connector¶
SearchAI allows ingestion of content from GitHub Repositories and makes it Searchable. You can configure this connector to index content from one or more repositories at once.
Specifications
Type of Repository | Cloud |
Extractive Model for Answer Generation | Yes |
Generative Model for Answer Generation | Yes |
Supported Content | Issues |
Authorization Support¶
Search AI supports two types of authentication for communication with GitHub.
- Using Personal Access Token
- OAuth 2.0 authentication
Prerequisites - GitHub Configuration¶
To use Personal Access Token for authentication, go to the Developer Settings in your GitHub account and generate a token.
To use OAuth authentication, register a new OAuth application. Provide the basic details of the app. Use one of the following as the callback URLs, depending on your region or deployment.
- JP Region Callback URL: https://jp-bots-idp.kore.ai/workflows/callback
- DE Region Callback URL: https://de-bots-idp.kore.ai/workflows/callback
- Prod Callback URL: https://idp.kore.com/workflows/callback
This will generate client credentials and a token. These are required to configure the GitHub connector in Search AI.
GitHub Connector Configuration in Search AI¶
Configure the GitHub connector in Search AI. Provide the following fields for authentication with the GitHub application.
- Name: Unique identifier for the connector.
- Authorization Type: Select the type of authorization.
- Personal Access Token: If this auth type is selected, provide the generated token.
- OAuth 2.0: If this auth type is selected, provide the client credentials and the refresh token.
There are a few other fields that are used to map the content from the GitHub repositories. Currently, Search AI supports standard fields only; hence, it is not mandatory to provide those fields. The default values of the fields are automatically populated.
The following fields are used to map the content from the GitHub repositories. For each of the fields, use the default values for the standard implementation in GitHub.
Field | Description | Value |
GitHub Repositories | Comma-separated list of repositories from which data is to be ingested. | NA |
Id | Field to be used as the unique identifier of the repository when data is ingested from the GitHub repository. | Id |
Title | Field to be used as the title of the content. | title |
Content | Field to be used to get the searchable content for the GitHub repositories. | body |
URL | Field to be used as the URL This URL is used as citation when the content qualifies as the answer. | url |
CreateOn | Field to fetch the creation date for the cotent. This is used to identify the incremental change in the content during the sync activity with SearchAI. | created_at |
UpdateOn | Field to get the updation date for the cotent. This is used to identify the incremental change in the content during the sync activity with SearchAI. | updated_at |