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

# Плагины

> Используйте MCP-серверы, плагины OpenAPI и приложения Craft, чтобы работать с актуальными данными и выполнять действия

Плагины подключают агентов Yahont к инструментам, которыми пользуется ваша команда.
С помощью плагина агент может прочитать актуальные данные, например задачу в Linear, или выполнить действие,
например отправить ответ в Slack.

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

> [!NOTE]
>
> В Yahont CE 0.2 действия MCP и OpenAPI стали плагинами.
> Найдите их в разделе **Плагины** меню и в чате в **Действия → Плагины**.
> Приложения Craft переехали из **Craft → Приложения** в **Плагины** бокового меню Craft.

![Страница «Плагины» с MCP-сервером и приложением Craft для Slack](https://mintcdn.com/yahont-ai/j0GvO8-A4kQYH_ed/assets/overview/core_features/plugins/member_plugins_directory.webp?fit=max\&auto=format\&n=j0GvO8-A4kQYH_ed\&q=85\&s=e76fe836de3b9ae95bd16d3c51f306cb)

## Типы плагинов

| Тип | Что делает | Где можно использовать |
| - | - | - |
| **MCP** | Подключается к серверу [Model Context Protocol](https://modelcontextprotocol.io/), например Linear, Notion или Atlassian | Чат, свои агенты и Craft |
| **OpenAPI** | Вызывает REST API, который ваш администратор описывает схемой OpenAPI | Чат и свои агенты |
| **Приложение Craft** | Позволяет Craft действовать от вашего имени в Slack, Gmail, Google Calendar, Google Drive, Notion, Linear, GitHub, HubSpot или Zendesk | Только Craft |

О приложениях Craft читайте в разделе [Приложения Craft](https://docs.yahont.ai/overview/core_features/craft_apps.md).

### Плагины и знания Yahont

Плагины и [коннекторы](https://docs.yahont.ai/overview/core_features/connectors.md) дают агентам разный доступ.

* **Знания Yahont** — это индекс документов компании. Yahont применяет права источника,
  поэтому вы находите только доступные вам документы. Поиск работает только на чтение.
* **Плагины** обращаются к внешнему сервису в реальном времени. Когда вы подключаете собственный аккаунт, сервис
  применяет ваши права. Плагин читает только то, что доступно вашему аккаунту, и меняет содержимое,
  только если это разрешают ваш аккаунт и ваш администратор.

## Подключение плагина

Выберите **Плагины** в боковом меню чата или в боковом меню Craft.

Значок состояния каждого плагина показывает, где вы можете его использовать: **Основной чат**,
**Свои агенты** и **Craft**.

**1. Подключите свой аккаунт**

Нажмите на плагин. Вкладка **Подключение** показывает, что нужно плагину:

| Состояние | Что делать |
| - | - |
| **Готов к работе** | Ничего. Плагину не нужен аккаунт. |
| **Подключение рабочего пространства** | Ничего. Подключение даёт ваше рабочее пространство. |
| **Использует ваш подключённый аккаунт** | Ничего. Плагин использует ваш вход в Yahont. |
| **Подключите свой аккаунт** | Нажмите **Подключить**, затем войдите в сервис. |
| **Добавьте свои учётные данные** | Введите значения, которые просит администратор, например личный ключ API. |
| **Нужна настройка рабочего пространства** | Попросите администратора завершить настройку плагина. |

Входите под тем аккаунтом, от имени которого должен действовать агент. Агент действует от имени этого аккаунта.

**2. Выберите, где использовать**

Задайте личные настройки по умолчанию:

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

![Сведения о плагине: «Готов к работе», «Включить в обычном чате» и «Включить в Craft»](https://mintcdn.com/yahont-ai/j0GvO8-A4kQYH_ed/assets/overview/core_features/plugins/member_plugin_mcp_detail.webp?fit=max\&auto=format\&n=j0GvO8-A4kQYH_ed\&q=85\&s=2d357fd786db6dd50da52884b7e7ca0f)

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

## Просмотр инструментов

Вкладка **Инструменты** показывает инструменты, которые плагин даёт агенту.
Для плагинов MCP в Craft **Настройки одобрения** показывают, какие инструменты выполняются автоматически,
какие просят вашего одобрения и какие выключены.

![Вкладка «Инструменты» плагина MCP с тремя инструментами](https://mintcdn.com/yahont-ai/j0GvO8-A4kQYH_ed/assets/overview/core_features/plugins/member_plugin_mcp_tools.webp?fit=max\&auto=format\&n=j0GvO8-A4kQYH_ed\&q=85\&s=aee1a8fefe585bf4f8827ec6ae003c27)

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

## Плагины в чате

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

![Меню действий в чате с открытым меню «Плагины»](https://mintcdn.com/yahont-ai/j0GvO8-A4kQYH_ed/assets/overview/core_features/plugins/chat_actions_plugins_flyout.webp?fit=max\&auto=format\&n=j0GvO8-A4kQYH_ed\&q=85\&s=c6a47f676dedfb3d131b35c76fe39529)

Агент сам решает, когда вызывать инструмент плагина. Чтобы направить его, назовите в сообщении плагин или сервис.
Например: «Используй DeepWiki и объясни, как репозиторий `onyx-dot-app/onyx` обрабатывает аутентификацию».

В чате агент вызывает инструменты плагинов без запроса на одобрение.
После изменения проверьте результат в самом сервисе.

> [!NOTE]
>
> Свои агенты используют плагины, которые выбрал создатель агента. Ваши настройки обычного чата на них не влияют. См.
> [Агенты](https://docs.yahont.ai/overview/core_features/agents.md).

## Отключение плагина

Откройте плагин и нажмите **Отключить**. Yahont удалит подключение вашего аккаунта.
Доступность в рабочем пространстве не изменится.

Если несколько плагинов используют одну и ту же настройку OAuth, у них общее подключение.
Отключение одного из них отключает все.

## Встроенные действия

В Yahont есть встроенные действия, которым плагин не нужен:

| Название | Описание | Требует настройки | Варианты поставщиков |
| - | - | - | - |
| Внутренний поиск | Поиск по проиндексированным документам и базе знаний вашей организации | Да | Встроен, компоненты можно заменять |
| Веб-поиск | Поиск актуальной информации в интернете | Да | Яндекс, Srezai, Exa, Serper, Brave, Google PSE, SearXNG, Tavily, Firecrawl |
| Открыть URL | Чтение содержимого веб-страницы, которую называет пользователь или модель | Нет | Встроено |
| Интерпретатор кода | Выполнение кода на Python, анализ данных и построение диаграмм | Нет | Встроен |
| Генерация изображений | Создание изображений по текстовому описанию | Да | OpenAI, Azure OpenAI, Google Vertex AI, RouterAI, Polza.AI |
| Агент по коду | Исследует репозиторий GitHub в изолированной песочнице и отвечает на вопросы о нём | Да | Встроен |

## Для администраторов

> [card] [Управление плагинами](https://docs.yahont.ai/admins/plugins/overview.md)
>
> Добавляйте плагины и задавайте доступность в рабочем пространстве.

> [card] [Приложения Craft](https://docs.yahont.ai/overview/core_features/craft_apps.md)
>
> Позвольте Craft действовать от вашего имени в Slack, Gmail, Notion и других приложениях.


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