> ## 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.

# Приложения

> Подключайте внешние инструменты, чтобы Craft мог получать актуальный контекст и выполнять одобренные действия

Приложения дают Craft контролируемый доступ к инструментам, в которых уже происходит ваша работа.
После подключения приложения Craft может получать актуальную информацию из вашего аккаунта и, если это разрешено,
создавать или изменять содержимое от вашего имени.

Примеры: найти контекст по клиенту в HubSpot, подготовить ответ в Gmail, создать задачу в Linear,
записать документ в Google Drive или открыть pull request в GitHub.

![Страница приложений Craft с подключёнными приложениями и ещё одним приложением, доступным для подключения](https://mintcdn.com/yahont-ai/uOUoHpXrpfUMZdwx/assets/overview/core_features/craft_apps.png?fit=max\&auto=format\&n=uOUoHpXrpfUMZdwx\&q=85\&s=e616e7aed3549ce618bc7a8ba243f807)

## Приложения, знания компании и файлы

В сессии Craft эти источники служат разным целям:

| Источник | Подходит для | Может изменять источник? |
| - | - | - |
| **Приложения** | Актуальная информация и действия в подключённом аккаунте. | Да, если это разрешают приложение и политика действий. |
| **Знания Yahont** | Поиск по проиндексированным материалам компании, к которым у вас уже есть доступ. | Нет. Поиск работает только на чтение. |
| **Вложения сессии** | Файлы, нужные для одной сессии. | Craft работает с копией в песочнице. |
| **Пользовательская библиотека** | Шаблоны и справочные файлы, которые вы используете во всех сессиях. | Craft читает синхронизированные файлы библиотеки, а новую работу записывает в результат сессии. |

## Доступные приложения

На странице приложений отображаются только приложения, включённые вашей организацией.
В Yahont есть встроенная поддержка:

| Приложение | Примеры использования |
| - | - |
| **Slack** | Поиск по диалогам, чтение сообщений, публикация обновлений и загрузка файлов. |
| **Google Calendar** | Проверка доступности, чтение, создание, изменение и удаление событий. |
| **Google Drive** | Поиск и чтение файлов, экспорт содержимого, создание и редактирование файлов и документов Google Docs. |
| **Gmail** | Поиск по почте, чтение цепочек и вложений, управление черновиками и отправка сообщений. |
| **Linear** | Чтение задач и проектов, создание задач и добавление комментариев. |
| **GitHub** | Просмотр репозиториев, задач и pull request; создание задач, веток, файлов и pull request. |
| **HubSpot** | Поиск контактов, компаний и сделок, создание и обновление записей CRM. |
| **Notion** | Поиск и чтение содержимого рабочего пространства, создание и обновление страниц, баз данных, блоков и комментариев. |

Ваша организация также может предоставить собственные приложения для API или сервисов,
которых нет во встроенном каталоге. Доступные вам действия зависят от доступа, предоставленного внешним сервисом,
и от политик вашей организации.

## Подключение приложения

**1. Откройте «Приложения»**

Выберите **Приложения** на боковой панели Craft. Сначала показываются подключённые аккаунты, а всё остальное,
что включила ваша организация, находится в разделе **Обзор приложений**.

**2. Подключите аккаунт**

Нажмите **Подключить**. Встроенные приложения открывают процесс авторизации сервиса.
Пользовательское приложение может вместо этого запросить поля, заданные администратором.

**3. Проверьте доступ**

Во внешнем сервисе подтвердите аккаунт и предоставляемые разрешения. Когда настройка завершится,
приложение появится в разделе **Подключено**.

**4. Используйте его в сессии**

Назовите приложение в запросе или выберите **+** > **Приложения** и укажите его. Например:
«Кратко изложи обсуждение запуска в Slack и подготовь письмо с продолжением в Gmail».

Craft также может понять, что для работы нужно неподключённое приложение.
В этом случае в сессии появится карточка подключения с вариантами **Подключить** и **Не сейчас**. Подключите приложение,
чтобы текущая задача продолжилась, или выберите **Не сейчас** и попросите Craft использовать другой источник.

> [!TIP]
>
> Подключайте тот аккаунт, от имени которого должен действовать Craft. Например, аккаунт Gmail, который вы авторизуете,
> — это аккаунт, из которого Craft читает почту и в котором создаёт черновики и отправляет письма.

## Как направить Craft к нужным данным

Подключение приложения делает его доступным, но в запросе всё равно нужно указать нужную область.
По возможности указывайте конкретные названия, даты, каналы, репозитории, проекты, папки или записи.

| Цель | Пример запроса |
| - | - |
| **Подкрепить материал** | «Подготовь обзор аккаунта за 2 квартал по сделке Acme в HubSpot, каналу `#acme-account` в Slack и последним заметкам в Drive». |
| **Подготовить, затем выполнить** | «Изучи обсуждение запуска в Slack, подготовь краткое письмо с продолжением и дождись моего одобрения перед отправкой». |
| **Обновить рабочий процесс** | «Найди в Linear нерешённые блокеры запуска, сгруппируй их по ответственным и добавь комментарий к задачам без следующего шага». |
| **Выполнить работу с кодом** | «Изучи открытую задачу в GitHub, внеси запрошенное изменение в документацию и открой pull request на проверку». |

## Обработка запросов на одобрение

Организация управляет каждым действием приложения с помощью одной из трёх политик:

| Политика | Что вы увидите |
| - | - |
| **Автоодобрение** | Craft выполняет действие без остановки. Обычно для безопасных операций чтения. |
| **Спрашивать** | Craft останавливается и показывает карточку одобрения перед отправкой запроса. |
| **Запрещать** | Craft не может выполнить действие и сообщает, что оно заблокировано. |

Если для действия выбрана политика **Спрашивать**, разверните карточку одобрения,
чтобы перед решением проверить приложение, действие, описание и содержимое запроса.

![Карточка одобрения Craft для публикации сообщения в Slack с вариантами: одобрить разово, одобрить на сессию или отклонить](https://mintcdn.com/yahont-ai/uOUoHpXrpfUMZdwx/assets/overview/core_features/craft_approval_card.png?fit=max\&auto=format\&n=uOUoHpXrpfUMZdwx\&q=85\&s=f9e9071e52f00d2d78f005ad60a0cc61)

| Выбор | Результат |
| - | - |
| **Одобрить разово** | Разрешает только показанный запрос. |
| **Одобрить на сессию** | Разрешает подходящие действия до конца текущей сессии. Постоянное разрешение не создаётся. |
| **Отклонить** | Блокирует запрос. Craft получает отказ и может предложить другой подход. |

Перед одобрением убедитесь, что:

* Приложение и подключённый аккаунт — те, которые вы имели в виду.
* Назначение (канал, получатель, репозиторий, календарь или запись) указано верно.
* Содержимое и данные запроса соответствуют тому, что вы просили сделать Craft.
* Действие не шире и не разрушительнее, чем необходимо.

> [!WARNING]
>
> Для отправки, удаления, изменений, видимых клиентам,
> изменений календаря и других значимых действий выбирайте **Одобрить разово**.
> Если срок одобрения истёк до вашего ответа, запрос завершается отказом и не выполняется.

## Приложения в запланированных задачах

[Запланированная задача](https://docs.yahont.ai/overview/core_features/craft_scheduled_tasks.md) выполняется без вашего присутствия.
Выберите ожидаемые приложения в разделе **Заранее одобренные приложения**, чтобы они могли действовать,
не дожидаясь ответа в реальном времени.

Предварительное одобрение действует только для этой запланированной задачи.
Действие приложения с политикой **Запрещать** остаётся заблокированным, а приложение, которое вы не одобрили заранее,
может оставить запуск в ожидании одобрения.

## Отключение приложения

Откройте **Приложения**, найдите аккаунт в разделе **Подключено** и нажмите **Отключить**.
Craft больше не сможет выполнять авторизованные запросы через это подключение. Позже вы можете подключить его снова,
повторно пройдя процесс подключения.

> [!NOTE]
>
> Исходные учётные данные приложений никогда не попадают в рабочее пространство песочницы Craft.
> Прокси песочницы добавляет их только в одобренные исходящие запросы.
> Полную модель доверия и сетевого взаимодействия смотрите в разделе [Архитектура Craft](https://docs.yahont.ai/security/architecture/craft.md).

## Устранение неполадок

> [accordion] Приложение не отображается
>
> Ваша организация не включила его, или его настройка не завершена.
> Попросите администратора проверить настройки приложения и ваш доступ.
> Администраторы могут воспользоваться [руководством по настройке приложений Craft](https://docs.yahont.ai/admins/plugins/craft_apps.md).

> [accordion] Не удаётся пройти процесс подключения
>
> Убедитесь, что выбран нужный внешний аккаунт,
> что окно настройки разрешено открыться и что запрошенный доступ предоставлен.
> Для пользовательского приложения уточните у администратора поля учётных данных.
> Затем вернитесь в «Приложения» и повторите попытку.

> [accordion] Craft не может выполнить действие
>
> Возможно, действие запрещено политикой, выходит за рамки доступа подключённого аккаунта,
> отклонено или истекло в ожидании одобрения. Craft не повторяет заблокированное действие автоматически;
> измените запрос или обратитесь к администратору, если действие должно быть доступно.

> [accordion] Запланированная задача ожидает одобрения
>
> Измените задачу и проверьте, что нужное приложение выбрано в разделе **Заранее одобренные приложения**.
> Если оно уже выбрано, возможно, администратор запретил это действие или для запуска нужно другое приложение.

> [card] [Для администраторов](https://docs.yahont.ai/admins/plugins/craft_apps.md)
>
> Включайте встроенные и пользовательские приложения, настраивайте учётные данные и задавайте политики действий.

> [card] [Использование навыков](https://docs.yahont.ai/overview/core_features/craft_skills.md)
>
> Дайте Craft повторно используемые методы, примеры, шаблоны и вспомогательные файлы.


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