> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket Connector

> Доступ к знаниям из ваших репозиториев Bitbucket (только Cloud)

## Как это работает

Коннектор Bitbucket индексирует все запросы на слияние (pull request) из указанного репозитория Bitbucket Cloud,
проекта или всего рабочего пространства.

* Он индексирует запросы на слияние в состояниях `OPEN`, `MERGED` и `DECLINED`, включая их заголовки и описания.
* Он также фиксирует ключевые метаданные: автора, рецензентов, текущее состояние, время создания и обновления
  и прямую ссылку на исходный запрос на слияние в Bitbucket.

## Настройка

> [!NOTE]
>
> Этот коннектор можно использовать только с Bitbucket Cloud.

### Авторизация

Коннектор Bitbucket использует для аутентификации API-токен.

Чтобы создать API-токен:

**1. Войдите в Bitbucket**

Войдите в свой аккаунт Bitbucket.

**2. Откройте настройки аккаунта**

Нажмите значок шестерёнки **Settings** в правом верхнем углу верхней панели навигации.

**3. Откройте настройки аккаунта Atlassian**

В разделе **Personal settings** выберите **Atlassian account settings**.

**4. Перейдите на вкладку Security**

Выберите вкладку **Security** на верхней панели навигации.

**5. Управление API-токенами**

Выберите **Create and manage API tokens**.

**6. Создайте токен с областями**

Выберите **Create API token with scopes**.

**7. Назовите токен**

Задайте API-токену имя и срок действия, обычно связанные с приложением, которое будет использовать токен,
и нажмите **Next**.

**8. Выберите Bitbucket**

Выберите **Bitbucket** в качестве приложения и нажмите **Next**.

**9. Выберите области**

Выберите области (разрешения), которые нужны API-токену, и нажмите **Next**.

* **Projects**: `read:project:bitbucket`
* **Repositories**: `read:repository:bitbucket`
* **Pull Requests**: `read:pullrequest:bitbucket`

**10. Создайте токен**

Проверьте токен и нажмите кнопку *Create token*. На странице отобразится новый API-токен.

**11. Сохраните токен**

Скопируйте созданный API-токен и сохраните его или вставьте в приложение, которому вы хотите дать доступ.

> [!NOTE]
>
> Токен показывается только один раз, и позже получить его нельзя.

Актуальные инструкции смотрите в [официальной документации
Bitbucket](https://support.atlassian.com/bitbucket-cloud/docs/create-an-api-token/).

### Индексирование

**1. Откройте коннектор Bitbucket**

Откройте панель администратора и выберите коннектор **Bitbucket**.

**2. Создайте учётные данные**

Нажмите **Создать новые учётные данные** и укажите:

* **Название**: понятное название ваших учётных данных.
* **Email**: адрес электронной почты вашего аккаунта Bitbucket.
* **API-токен**: API-токен, созданный на предыдущем шаге.

  ![BitbucketConnector](https://mintcdn.com/yahont-ai/GgKRVXXDNIirDkuK/assets/admins/connectors/bitbucket/BitbucketConnectorCred.png?fit=max\&auto=format\&n=GgKRVXXDNIirDkuK\&q=85\&s=5a38e3aba20bbb716814658f5efd6329)

**3. Настройте сведения о коннекторе**

Заполните сведения о коннекторе:

* **Название**: понятное название коннектора.
* **Workspace name**: значение `WORKSPACE_NAME` из вашего URL Bitbucket (`https://bitbucket.org/{WORKSPACE_NAME}/...`).
* **Repositories or Projects (необязательно)**:
  список slug репозиториев или ключей проектов через запятую для индексации.

  ![BitbucketConnector](https://mintcdn.com/yahont-ai/GgKRVXXDNIirDkuK/assets/admins/connectors/bitbucket/BitbucketConnector.png?fit=max\&auto=format\&n=GgKRVXXDNIirDkuK\&q=85\&s=4c63994c261338424ee539615b3aba2d)

Эта конфигурация проиндексирует все запросы на слияние из указанных репозиториев.
Также можно настроить индексацию всех репозиториев проекта или всего рабочего пространства.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.