snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-agents.mdx

@@ -0,0 +1,30 @@
+---
+title: Агенты ИИ
+description: Интегрируйте возможности ИИ напрямую в рабочие процессы автоматизации.
+---
+
+## Обзор
+
+Интегрируйте возможности ИИ напрямую в рабочие процессы автоматизации для интеллектуальной обработки данных и принятия решений.
+
+## Возможности
+
+| Функция                      | Описание                                             |
+| ---------------------------- | ---------------------------------------------------- |
+| **Действия ИИ**              | Добавляйте шаги на базе ИИ в любой рабочий процесс   |
+| **Обогащение данных**        | Автоматически обогащайте записи внешними данными     |
+| **Классификация**            | Классифицируйте записи на основе анализа содержимого |
+| **Резюмирование**            | Создавайте краткие сводки из текстовых полей         |
+| **Пользовательские промпты** | Определяйте, как именно ИИ обрабатывает ваши данные  |
+
+## Сценарии использования
+
+* **Оценка лидов**: Автоматически оценивайте и расставляйте приоритеты для входящих лидов
+* **Очистка данных**: Стандартизируйте названия компаний и контактную информацию
+* **Черновики писем**: Генерируйте черновики последующих писем на основе заметок встречи
+* **Маршрутизация записей**: Назначайте записи нужному участнику команды в зависимости от содержания
+
+## Связанные материалы
+
+* [Обзор рабочих процессов](/l/ru/user-guide/workflows/overview) — основы автоматизации
+* [Разрешения ИИ](/l/ru/user-guide/ai/capabilities/permissions-access-control) — контроль доступа для агентов ИИ

packages/twenty-docs/l/ru/user-guide/ai/capabilities/ai-chatbot.mdx

@@ -0,0 +1,37 @@
+---
+title: Чат-бот на базе ИИ
+description: Интеллектуальный помощник, который помогает взаимодействовать с данными вашей CRM на естественном языке.
+---
+
+## Обзор
+
+Задавайте вопросы на естественном языке и получайте ассистент и объясняйте данные CRM для вас.
+
+## Возможности
+
+| Функция                           | Описание                                                                                   |
+| --------------------------------- | ------------------------------------------------------------------------------------------ |
+| **Запросы на естественном языке** | Задавайте вопросы на простом английском вместо создания фильтров                           |
+| **Полный доступ к данным**        | Запрашивайте записи, связи и метрики во всём рабочем пространстве                          |
+| **Контекст страницы**             | Ссылайтесь на "эту компанию" или "эту сделку" в зависимости от текущего контекста страницы |
+| **Диалоговый режим**              | Последующие вопросы сохраняют контекст предыдущих запросов                                 |
+
+## Примеры взаимодействий
+
+### Поиск записей
+
+* "Покажи все сделки свыше $50,000"
+* "Найди контакты, которым я не писал за последние 2 недели"
+* "Выведи список компаний в сфере здравоохранения"
+
+### Получение аналитики
+
+* "Какова общая стоимость моей воронки продаж?"
+* "Сколько сделок было закрыто в прошлом месяце?"
+* "На каком этапе больше всего застрявших сделок?"
+
+### Использование контекста страницы
+
+* "Подытожь мои взаимодействия с этим человеком" (на странице контакта)
+* "Какие сделки связаны с этой компанией?" (на странице компании)
+* "Когда эта сделка в последний раз была обновлена?" (на странице сделки)

packages/twenty-docs/l/ru/user-guide/ai/capabilities/mcp.mdx

@@ -0,0 +1,137 @@
+---
+title: Сервер MCP
+description: Подключайте ИИ-ассистентов к вашему рабочему пространству Twenty с помощью протокола Model Context Protocol.
+---
+
+Twenty предоставляет сервер [MCP](https://modelcontextprotocol.io/), чтобы ИИ-ассистенты — Claude Desktop, Claude Code, Cursor, ChatGPT и другие — могли читать и записывать ваши данные CRM на естественном языке.
+
+Используйте **URL рабочей области** (URL, который вы используете для доступа к Twenty) в качестве конечной точки MCP. В Twenty Cloud URL вашей рабочей области может быть `https://{mycompany}.twenty.com` или собственный домен. Сервер доступен по адресу:
+
+| Среда                       | Конечная точка MCP                                                                |
+| --------------------------- | --------------------------------------------------------------------------------- |
+| **Облако**                  | `https://{your-workspace-url}/mcp` (например, `https://mycompany.twenty.com/mcp`) |
+| **Самостоятельный хостинг** | `https://{your-domain}/mcp`                                                       |
+
+## Методы аутентификации
+
+Есть два способа аутентифицировать ваш MCP-клиент: **OAuth** (рекомендуется) или **API Key**.
+
+### Вариант A — OAuth (рекомендуется)
+
+При использовании OAuth ваш MCP-клиент откроет окно браузера для входа в систему. Секреты не хранятся в файлах конфигурации, а токены обновляются автоматически.
+
+<Note>
+Для OAuth требуется MCP-клиент, поддерживающий [спецификацию авторизации MCP](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). Её поддерживают Claude Desktop, Claude Code, Cursor и ChatGPT.
+</Note>
+
+Добавьте это в конфигурацию вашего MCP-клиента, заменив `{your-workspace-url}` на хост вашей рабочей области (например, `mycompany.twenty.com`):
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp"
+    }
+  }
+}
+```
+
+Вот и всё — ключ API не требуется. При первом подключении клиент выполнит:
+
+1. Обнаружит метаданные OAuth Twenty через `/.well-known/oauth-protected-resource` и `/.well-known/oauth-authorization-server`
+2. Зарегистрирует себя как OAuth-клиент через динамическую регистрацию клиентов (RFC 7591)
+3. Откроет браузер для авторизации доступа
+4. Получит токены и подключится к серверу MCP
+
+При последующих подключениях используются сохранённые токены, которые автоматически обновляются.
+
+### Вариант B — ключ API
+
+Если ваш MCP-клиент не поддерживает OAuth или вы предпочитаете статические учётные данные, передайте ключ API в заголовке `Authorization`:
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+<Warning>
+Ваш ключ API предоставляет доступ к данным рабочей области. Не храните его в системе контроля версий и общих dotfiles.
+</Warning>
+
+Чтобы создать ключ API, перейдите в **Settings → MCP & APIs → API → + Create key**. См. [API](/l/ru/developers/extend/api#create-an-api-key) для подробностей.
+
+## Быстрый старт
+
+### 1. Скопируйте конфигурацию
+
+Перейдите в **Settings → MCP & APIs → MCP** в Twenty. Выберите метод аутентификации (OAuth или ключ API), скопируйте фрагмент JSON (в нём уже будет использован URL вашей рабочей области) и вставьте его в файл конфигурации вашего MCP-клиента.
+
+| Клиент             | Расположение файла конфигурации                                                                                                                                                 |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) или `%APPDATA%\Claude\claude_desktop_config.json` (Windows)                                           |
+| **Claude Code**    | `~/.claude.json` (пользователь) или `.mcp.json` (проект)                                                                                                                        |
+| **Cursor**         | `.cursor/mcp.json` в вашем проекте или `~/.cursor/mcp.json` глобально                                                                                                           |
+| **ChatGPT**        | Включите режим разработчика в **Settings → Apps & Connectors → Advanced settings**, затем используйте **Create** в **Settings → Apps & Connectors**, чтобы добавить сервер MCP. |
+
+### 2. Подключение
+
+Перезапустите ваш MCP-клиент (или перезагрузите конфигурацию). Если используется OAuth, вы будете перенаправлены в Twenty для авторизации доступа. Если используется ключ API, подключение произойдёт сразу.
+
+### 3. Начните использовать
+
+Попросите вашего ИИ-ассистента взаимодействовать с вашей CRM:
+
+* *"Покажи мне 5 последних созданных компаний"*
+* *"Создай новый контакт по имени Jane Doe в компании Acme Corp"*
+* *"Найди все открытые сделки стоимостью более $10 000"*
+
+## Доступные инструменты
+
+После подключения сервер MCP предоставляет инструменты, отражающие API Twenty. Рекомендуемый рабочий процесс:
+
+1. **`learn_tools`** — получить схему входных данных для конкретных инструментов
+2. **`execute_tool`** — запустить инструмент
+
+Вам не нужно запоминать названия инструментов. Спросите у вашего ИИ-ассистента, что он умеет, и он автоматически вызовет `learn_tools`.
+
+## Разрешения
+
+Подключения MCP наследуют разрешения аутентифицированного пользователя (OAuth) или роль, назначенную ключу API. Чтобы ограничить действия, доступные серверу MCP:
+
+* **OAuth**: Применяется роль пользователя в рабочей области.
+* **API Key**: Назначьте ключу API роль в **Settings → Members → Roles**. См. [Разрешения](/l/ru/user-guide/permissions-access/capabilities/permissions).
+
+## Конфигурация для самостоятельного хостинга
+
+Для экземпляров с самостоятельным хостингом замените `{your-workspace-url}` на URL вашего сервера. Убедитесь, что значение `SERVER_URL` в вашей среде соответствует публичному URL экземпляра Twenty — оно используется для генерации метаданных обнаружения OAuth.
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+Конечная точка MCP, конечные точки OAuth и метаданные обнаружения формируются на основе этого значения.
+
+## Устранение неполадок
+
+**Ошибки "Unauthorized" или 401**
+
+* OAuth: повторно авторизуйтесь, очистив сохранённые токены в вашем MCP-клиенте и переподключившись.
+* API Key: убедитесь, что ключ действителен и не истёк. При необходимости сгенерируйте его заново.
+
+**Процесс OAuth не открывает браузер**
+
+* Убедитесь, что ваш MCP-клиент поддерживает MCP Authorization. Если нет — используйте метод с ключом API.
+
+**Тайм-аут подключения**
+
+* Убедитесь, что URL конечной точки MCP доступен с вашего компьютера. Для экземпляров с самостоятельным хостингом проверьте, что сервер запущен и значение `SERVER_URL` установлено корректно.

packages/twenty-docs/l/ru/user-guide/ai/capabilities/permissions-access-control.mdx

@@ -0,0 +1,35 @@
+---
+title: Разрешения и контроль доступа
+description: Управляйте тем, к чему агенты ИИ могут получать доступ и что они могут изменять в вашем рабочем пространстве.
+---
+
+## Обзор
+
+Агенты ИИ соблюдают вашу существующую структуру разрешений. Это особенно важно для команд, которые хотят точно контролировать, к чему автоматизированные процессы ИИ могут получать доступ или что они могут изменять в своём рабочем пространстве.
+
+## Назначить роль агенту ИИ
+
+1. Перейдите в **Настройки → Участники → Роли**
+2. Нажмите на роль, которую вы хотите назначить
+3. Откройте вкладку **Назначение**
+4. В разделе **Агенты ИИ** нажмите **+ Назначить агенту ИИ**
+5. Выберите агента ИИ из списка
+6. Подтвердите назначение
+
+## Зачем назначать роли агентам ИИ?
+
+| Преимущество                 | Описание                                                                                    |
+| ---------------------------- | ------------------------------------------------------------------------------------------- |
+| **Безопасность**             | Ограничьте данные, к которым агенты ИИ могут получать доступ или которые они могут изменять |
+| **Соответствие требованиям** | Обеспечьте, чтобы ИИ обрабатывал только необходимые ему данные                              |
+| **Контроль**                 | Предотвращайте непреднамеренные действия автоматизаций ИИ                                   |
+| **Возможность аудита**       | Отслеживайте, какие действия были выполнены каким агентом                                   |
+
+<Note>
+Для агентов ИИ, работающих в рамках рабочих процессов, назначение роли гарантирует, что агент не сможет получать доступ к данным или изменять их за пределами своей предназначенной области — даже если у рабочего процесса более широкие разрешения.
+</Note>
+
+## Связанные материалы
+
+* [Разрешения](/l/ru/user-guide/permissions-access/capabilities/permissions) — подробная информация о создании и управлении ролями
+* [Агенты ИИ](/l/ru/user-guide/ai/capabilities/ai-agents) — возможности ИИ в рабочих процессах

packages/twenty-docs/l/ru/user-guide/ai/how-tos/ai-faq.mdx

@@ -0,0 +1,31 @@
+---
+title: Часто задаваемые вопросы об ИИ
+description: Часто задаваемые вопросы о функциях ИИ в Twenty.
+---
+
+<AccordionGroup>
+
+  <Accordion title="Какие возможности ИИ доступны?">
+    У ИИ есть две основные возможности:
+
+    1. **ИИ-чат-бот**: контекстный помощник, который может получать доступ к вашим данным в Twenty и помогать с запросами
+    2. **ИИ-агенты в рабочих процессах**: интеллектуальная автоматизация, которая может обрабатывать данные, принимать решения и выполнять задачи в рамках ваших рабочих процессов
+  </Accordion>
+
+  <Accordion title="Есть ли у ИИ-агентов доступ ко всем моим данным?">
+    Агенты AI работают под разрешенной системой. Вы можете назначать ИИ-агентам конкретные роли в **Настройки → Участники → Роли**, получая полный контроль над тем, к каким данным у них есть доступ и какие действия они могут выполнять.
+  </Accordion>
+
+  <Accordion title="Как работают кредиты ИИ?">
+    Действия ИИ расходуют кредиты рабочих процессов в зависимости от сложности задачи и используемой модели ИИ.
+  </Accordion>
+
+  <Accordion title="Могу ли я использовать собственные модели ИИ?">
+    В облаке вы можете использовать только модели ИИ, предоставленные Twenty. В вашем саморазмещённом инстансе вы можете использовать собственные модели ИИ после получения лицензии Organization.
+  </Accordion>
+
+  <Accordion title="Я не вижу роль, которую я назначаю агенту ИИ, где это?">
+    По умолчанию список ролей отфильтрован так, чтобы показывать только роли, назначаемые участникам рабочего пространства. Если роль присваивается только агентам ИИ, вам нужно изменить фильтр, чтобы включить роли агента AI-Агента.
+  </Accordion>
+
+</AccordionGroup>

packages/twenty-docs/l/ru/user-guide/ai/overview.mdx

@@ -0,0 +1,58 @@
+---
+title: ИИ
+description: Функции на базе ИИ в Twenty.
+---
+
+<Frame>
+  <img src="/images/user-guide/workflows/robot.png" alt="ИИ" />
+</Frame>
+
+## Возможности
+
+В настоящее время Twenty предлагает:
+
+### 1. Чат-бот на базе ИИ
+
+Разговорный помощник, который понимает ваш контекст и имеет доступ ко всем вашим данным Twenty.
+
+**Ключевые возможности:**
+
+* **Полный доступ к данным**: Запрашивайте любую запись, связь или метрику в вашем рабочем пространстве
+* **Осведомлённость о контексте страницы**: Ссылайтесь на «эту компанию» или «эту сделку» в зависимости от того, где вы находитесь в Twenty
+* **Естественный язык**: Задавайте вопросы и получайте ответы без навигации по меню
+
+**Примеры подсказок:**
+
+* "Какие сделки закрываются в этом месяце?"
+* "Какие сделки находятся на этапе «Переговоры» более 30 дней?"
+* "Суммируйте мои взаимодействия с этим человеком"
+
+### 2. ИИ-агенты в рабочих процессах
+
+Расширяйте свои рабочие процессы с помощью действий на базе ИИ и автономных агентов.
+
+**Ключевые возможности:**
+
+* **Действия ИИ**: Используйте ИИ для обогащения данных, классификации записей, создания сводок и многого другого
+* **Автономные агенты**: Позвольте агентам выполнять многошаговые задачи в рамках рабочего процесса
+* **Пользовательские подсказки**: Определяйте точно, как ИИ должен обрабатывать ваши данные
+
+**Сценарии использования:**
+
+* Автоматически классифицируйте входящие лиды
+* Обогащайте данные о компании из открытых источников
+* Генерируйте черновики последующих писем на основе заметок встречи
+* Оценивайте сделки на основе шаблонов вовлеченности
+
+## Разрешения и контроль доступа
+
+ИИ-агенты управляются через существующую систему разрешений:
+
+1. Перейдите в **Настройки → Участники → Роли**
+2. Настройте, к каким данным каждый ИИ-агент может получать доступ
+3. Задайте права на чтение и запись для каждого объекта
+
+Это гарантирует, что ИИ-агенты соблюдают ваши политики управления данными и получают доступ только к необходимому.
+
+* Следите за обновлениями разработки в нашем [GitHub](https://github.com/twentyhq/twenty)
+* Присоединяйтесь к нашему [Discord](https://discord.gg/UfGNZJfAG6), чтобы делиться отзывами и запросами на функции