# Облачные агенты

Источник: https://razum.sh/docs/agents/cloud

> Агент в облаке работает с репозиторием GitHub, пока ваш компьютер выключен, и открывает pull request.

Облачный агент работает не на вашем компьютере, а на облачном компьютере аккаунта. Он
клонирует репозиторий, делает задачу в своей ветке и открывает pull request. Ноутбук можно
закрыть — работа продолжится.

## Запустить из приложения

1. Откройте проект — git-репозиторий с публичным адресом `https://` (например, на GitHub).
2. Под полем ввода выберите место «Облако».
3. Опишите задачу.

Облачный агент копирует репозиторий с удалённого адреса, а не с вашего диска: свежие
правки, которые вы не запушили, он не увидит.

## Запустить из браузера

В [веб-версии](https://razum.sh/workbench/) под полем ввода выберите «Подключить репозиторий…»
и вставьте ссылку `https://github.com/owner/repo` или `owner/repo`. Облако склонирует
репозиторий, и новые чаты будут начинаться в нём, пока вы не выберете другое место.
«Без репозитория» — для задач без кода.

Приватный репозиторий откроется, если GitHub подключён к аккаунту — через плагин
[GitHub](https://razum.sh/docs/customize/plugins).

## Ветки и pull request

Настройки — «Настройки → Облачные агенты → Git»:

| Настройка     | Что делает                                                                                |
| ------------- | ----------------------------------------------------------------------------------------- |
| Базовая ветка | От неё агент начинает работу и в неё открывает PR. Пусто — ветка репозитория по умолчанию |
| Префикс ветки | Начало имени веток, которые создаёт агент                                                 |
| Создавать PR  | «Всегда» — открыть pull request, когда агент закончил. «Никогда» — только запушить ветку  |

Вливает pull request облачный агент только по вашей просьбе.

## Сеть и секреты

«Настройки → Облачные агенты → Безопасность»:

* **Доступ в сеть** — куда облачные агенты могут ходить по сети.
* **Мои секреты** — переменные окружения для облачных агентов: ключи тестовых окружений,
  токены сборки. Агент получает их как переменные, а не текстом в чате.

## Подключения вашего компьютера

Некоторые подключения работают только через ваш компьютер: например, когда вход в сервис
привязан к вашей машине. Облачный агент тоже может ими пользоваться — пока приложение
запущено. При первом вызове компьютер спросит: «Никогда», «Один раз» или «Всегда». →
[Подключения](https://razum.sh/docs/customize/connections#через-компьютер)