openpencil/packages/docs/ru/programmable/ai-chat.md
Danila Poyarkov c3412a44fc
docs: polish localized documentation
* docs: polish localized documentation

- Rewrite Russian documentation for natural terminology and current source parity\n- Continue the Polish editorial pass across guides and SDK references\n- Refresh shared localized SDK API data imports

* docs(pl): complete editorial pass

- Rewrite the remaining advanced Vue SDK references\n- Refresh the Figma compatibility matrix against the canonical source\n- Align terminology and behavior across every Polish documentation page

* docs(de): complete editorial pass

- Rewrite German guides, automation docs, and Vue SDK references\n- Restore current AI, export, component, and variable behavior\n- Refresh the Penpot comparison and Figma compatibility matrix

* docs(es): complete editorial pass

- Rewrite Spanish guides, automation docs, and Vue SDK references\n- Restore current AI, export, component, and variable behavior\n- Refresh the Penpot comparison and Figma compatibility matrix

* docs(fr): complete editorial pass

- Rewrite French guides, automation docs, and Vue SDK references\n- Restore current AI, export, component, and variable behavior\n- Refresh the Penpot comparison and Figma compatibility matrix

* docs: correct localized terminology

- Replace unnecessary English prose with natural localized terminology\n- Derive documentation aliases from named directory roots\n- Preserve English only for identifiers, APIs, and exact product terms

* docs(it): continue editorial pass

- Rewrite Italian user guides and automation documentation\n- Update Vue SDK composables and component references\n- Restore current AI, export, component, and variable behavior

* docs(it): complete editorial pass

- Finish Italian advanced SDK and reference documentation\n- Refresh the Penpot comparison and Figma compatibility matrix\n- Replace literal machine translations with natural technical prose

* docs(pl): refine property panel terminology

* docs: refine remaining localized prose

- Replace overfitted English prose in Polish feature documentation\n- Rewrite the Russian property-list reference in natural terminology

* docs(ru): rewrite Penpot comparison naturally

- Replace remaining English prose with natural Russian\n- Preserve code identifiers and library names only where required

* docs: rewrite localized feature overviews naturally

- Replace avoidable English prose in German, Spanish, and French\n- Keep identifiers and product names unchanged

* docs(de): refine property panel terminology

* docs: refine Spanish and French SDK terminology

* docs(ru): continue full prose audit

- Rewrite homepage, setup, navigation, and guide index naturally\n- Restore missing zoom shortcuts

* docs(ru): audit user and automation guides

- Rewrite selection, collaboration, and automation prose naturally\n- Preserve API identifiers while localizing ordinary terminology

* docs(ru): audit CLI inspection and analysis

* docs(ru): audit Vue SDK overview and guides

* docs(ru): audit Vue SDK API prose

- Localize ordinary component and composable terminology\n- Preserve API symbols and code identifiers

* docs(ru): audit advanced and gradient API references

* docs(ru): finish advanced API prose audit

* docs(ru): audit JSX renderer guide

* docs(ru): audit CLI export and scripting guides

* docs(pl): audit Penpot comparison prose

* docs(pl): audit selection and automation guides

* docs(pl): audit homepage and variable guides

* docs(pl): audit vector, layers, and Pen guides

* docs(pl): audit Auto layout and shape guides

* docs(pl): audit context menu and export guides

* docs(pl): audit JSX and analysis guides

* docs(pl): audit AI Chat guide

* docs(pl): audit components and CLI inspection

* docs(pl): audit scripting and SDK overview prose

* docs(pl): audit SDK API indexes

* docs(pl): audit SDK component references

* docs(pl): audit SDK composable references

* docs(ru): refine usePosition terminology

* docs(pl): audit advanced SDK references

* docs(pl): audit Figma compatibility matrix

* docs(pl): finish residual SDK terminology audit

* docs(pl): finish component terminology audit

* docs(pl): finish SDK guide terminology audit

* docs(de): begin full user guide prose audit

* docs(de): audit navigation, Pen, and layers guides

* docs(de): audit Auto Layout, shapes, menu, and export

* docs(de): audit components, text, and vector guides

* docs(de): audit variables and automation overview

* docs(de): audit AI Chat and collaboration guides

* docs(de): audit CLI inspection, analysis, and export

* docs(de): audit scripting and JSX guides

* docs(de): audit Vue SDK overview and guides

* docs(de): audit SDK API indexes

* docs(de): audit SDK component references

* docs(de): audit SDK composable references

* docs(de): audit advanced SDK references

* docs(de): audit Penpot comparison prose

* docs(de): audit Figma compatibility reference

* docs(es): begin full user guide prose audit

* docs(es): audit document organization guides

* docs(es): audit editing workflow guides

* docs(es): audit automation and collaboration prose

* docs(es): audit CLI inspection and export guides

* docs(es): audit CLI scripting guide

* docs(es): audit JSX and feature overview prose

* docs(es): audit Penpot comparison prose

* docs(es): audit SDK overview and guides

* docs(es): begin SDK component reference audit

* docs(es): audit SDK navigation component references

* docs(es): audit SDK color and layout components

* docs(es): begin SDK composable reference audit

* docs(es): audit SDK property composable references

* docs(es): audit SDK editor composable references

* docs(es): begin advanced SDK reference audit

* docs(es): audit advanced SDK state references

* docs(es): complete advanced SDK reference audit

* docs(es): audit Figma compatibility reference

* docs(es): complete residual terminology sweep

* docs(fr): begin full prose second audit

* docs(fr): audit AI and variables prose

* docs(fr): audit core user guide prose

* docs(fr): audit editing workflow guides

* docs(fr): audit CLI and JSX prose

* docs(fr): audit Penpot comparison prose

* docs(fr): audit SDK overview and guides

* docs(fr): begin SDK API reference audit

* docs(fr): audit SDK navigation component references

* docs(fr): audit SDK color and layout components

* docs(fr): begin SDK composable reference audit

* docs(fr): audit SDK property composable references

* docs(fr): audit editor composables and advanced APIs

* docs(fr): audit advanced SDK state references

* docs(fr): complete advanced SDK reference audit

* docs(fr): audit Figma compatibility reference

* docs(fr): complete residual terminology sweep

* docs(it): begin full prose second audit

* docs(it): audit document workflow guides

* docs(it): audit editing and automation prose

* docs(it): audit CLI and JSX prose

* docs(it): audit Penpot comparison and SDK guides

* docs(it): begin SDK API reference audit

* docs(it): audit SDK component and state references

* docs(it): audit residual SDK references

* docs(it): audit Figma compatibility reference

* docs(it): complete residual terminology sweep

* docs(i18n): verify residual locale terminology
2026-08-20 18:36:50 +03:00

79 lines
7.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: Чат с ИИ
description: Встроенный помощник с более чем 90 инструментами для создания и изменения дизайна.
---
# Чат с ИИ
Нажмите <kbd>⌘</kbd><kbd>J</kbd> или <kbd>Ctrl</kbd> + <kbd>J</kbd>. Помощник умеет создавать фигуры, менять стили и компоновку, работать с компонентами и анализировать документ.
## Настройка
1. Откройте панель чата.
2. Нажмите значок настроек.
3. Добавьте модель и настройте поставщика, идентификатор модели, учётные данные и возможности.
4. Сохраните модель и назначьте её для роли **Design agent**.
Можно создать несколько переиспользуемых моделей и отдельно назначить их для дизайна, проверки, быстрых задач и обработки изображений. Модели, использующие одно подключение к поставщику, совместно используют сохранённые учётные данные.
### Поставщики
| Поставщик | Модели | Настройка |
|-----------|--------|-----------|
| **OpenRouter** | Claude, GPT, Gemini, DeepSeek, Qwen и другие | Ключ API с [openrouter.ai](https://openrouter.ai) |
| **Anthropic** | Claude Sonnet 4.6, Claude Opus 4.6 | Ключ API с [console.anthropic.com](https://console.anthropic.com) |
| **OpenAI** | GPT-5.3 Codex, GPT-4.1, o3, o4-mini | Ключ API с [platform.openai.com](https://platform.openai.com) |
| **Google AI** | Gemini 3.1 Pro, Gemini 3 Flash | Ключ API с [aistudio.google.dev](https://aistudio.google.dev) |
| **Z.ai** | GLM-5.1, GLM-5, GLM-4.7 и семейство GLM-4.5 | Ключ API из [документации Z.ai](https://docs.z.ai/devpack/quick-start) |
| **MiniMax** | MiniMax M3, M2.7, M2.7-highspeed, M2.5, M2.1 | Ключ API с [platform.minimax.io](https://platform.minimax.io/user-center/basic-information/interface-key) |
| **Совместимый с OpenAI** | Любая конечная точка в формате OpenAI API | Собственные базовый URL и ключ; можно выбрать Completions API или Responses API |
| **Совместимый с Anthropic** | Любая конечная точка в формате Anthropic API | Собственные базовый URL и ключ |
Отдельный сервер и подписка OpenPencil не требуются: запросы отправляются поставщику напрямую с вашим ключом. В браузере действуют правила CORS поставщика. Разные развёртывания моделей также по-разному поддерживают потоковые вызовы инструментов. Результаты проверок и инструкции находятся в разделе [Совместимость поставщиков и моделей BYOK](/programmable/byok-provider-compatibility).
### Внешние подключения MCP
В настольной версии агенты ACP могут использовать доверенные удалённые серверы [Model Context Protocol](https://modelcontextprotocol.io/). Откройте **Настройки → Подключения MCP**, добавьте именованную конечную точку Streamable HTTP, при необходимости сохраните токен Bearer и включите подключение.
Токен хранится в настроенном хранилище учётных данных, а не в обычных настройках, и загружается только при запуске сеанса ACP.
Удалённый сервер должен работать через HTTPS. Для локальной разработки разрешены адреса обратной петли через HTTP. Включайте только сервер, которому доверяете: его инструменты могут читать внешние данные и выполнять действия с переданными учётными данными. Встроенный сервер MCP для дизайна подключается автоматически.
## Возможности
Помощник использует более 90 инструментов:
- **Создание:** фреймы, фигуры, текст, компоненты и страницы; JSX для сложных макетов.
- **Стиль:** заливки, обводки, эффекты, прозрачность, радиусы углов и режимы наложения.
- **Компоновка:** автоматическая компоновка, сетка, выравнивание, интервалы и размеры.
- **Компоненты:** создание компонентов, экземпляров и наборов, управление переопределениями.
- **Переменные:** создание и изменение переменных, коллекций и режимов, привязка к заливкам.
- **Запросы:** поиск объектов, селекторы XPath, чтение свойств, получение списка страниц, шрифтов и выделения.
- **Проверка:** `get_jsx`, `diff_jsx` и `describe` для анализа структуры, роли объекта и возможных проблем дизайна.
- **Анализ:** палитра, типографика, интервалы и повторяющиеся группы.
- **Экспорт:** PNG, SVG и JSX с классами Tailwind; визуальная проверка через `export_image`.
- **Векторы:** логические операции и изменение контуров.
## Визуальная проверка
После создания или изменения дизайна помощник может вызвать `export_image`, получить снимок результата и сопоставить его с исходным запросом. Так обнаруживаются проблемы компоновки, отсутствующие элементы и неверные цвета.
## Примеры запросов
- «Создай карточку с заголовком, описанием и синей кнопкой».
- «Сделай одинаковый радиус углов у всех кнопок на этой странице».
- «Какие шрифты используются в этом файле?»
- «Замени фон выделенного фрейма на градиент от синего к фиолетовому».
- «Экспортируй выделенный фрейм в SVG».
- «Найди все текстовые объекты с размером шрифта меньше 12».
- «Опиши роль выделенного компонента».
- «Покажи JSX этого фрейма».
## Советы
- Перед запросом выделите нужные объекты: помощник видит выделение.
- Точно указывайте цвета, размеры и положение.
- В одном сообщении можно изменить несколько объектов.
- Если результат не подходит, используйте отмену.
- После каждого вызова инструмента компоновка пересчитывается автоматически.