Как установить и настроить AI Chat для Optimizely CMS — полное руководство

Чат AI Assistant — это революционная функция, представленная в версии 3.0 Epicweb.Optimizely.AIAssistant, которая переносит диалоговый AI непосредственно в процесс редактирования Optimizely CMS. Вместо того, чтобы вручную заполнять поля или угадывать оптимальный контент, теперь вы можете вести естественный диалог с ИИ, работая со страницами, блоками и мультимедиа.

Думайте об этом как о наличии опытного контент-стратега, специалиста по SEO и технического писателя в одном лице, доступного 24 часа в сутки, 7 дней в неделю, прямо на панели инструментов вашей CMS.

Сила диалогового управления контентом. Часть 1.

Вместо этого традиционного рабочего процесса:

1. Open page editor
2. Think about SEO title
3. Write title
4. Check character count
5. Revise
6. Repeat for meta description
7. Manually check accessibility
8. Review content structure

Теперь вы можете сделать это:

You: "Analyze this page's SEO and suggest improvements"
AI: [Analyzes current page, identifies 3 issues]
You: "Apply those suggestions"
AI: [Updates SEO title, meta description, and heading structure] "Done! Review the changes?"

---

Смотреть: AI-чат в действии

Ключевые преимущества

Повышение производительности

• Создание контента в 10 раз быстрее – Создавайте SEO-оптимизированный контент за считанные секунды.
• Автоматизированные рабочие процессы – Позвольте ИИ решать повторяющиеся задачи
• Умные предложения – Получайте интеллектуальные рекомендации на основе вашего контента.
• Мгновенные операции – Обновляйте контент посредством естественного разговора

Улучшите качество контента

• SEO-оптимизация – ИИ предлагает удобные для поиска заголовки, описания и структуру.
• Последовательность – Поддерживать голос бренда во всем контенте
• Доступность – Автоматический замещающий текст и проверки соответствия WCAG.
• Многоязычный – Бесшовный перевод с учетом контекста

Интеллектуальная помощь

• Контекстно-зависимый – Понимает, над чем работаешь
• Возможности обучения – Адаптируется к вашим правилам содержания
• Помощь в режиме реального времени – Получайте ответы, не выходя из CMS
• Контент-анализ – Мгновенная обратная связь по читабельности, тону и структуре

Мощная интеграция инструментов

• Операции с контентом – Создавайте, читайте, обновляйте и публикуйте посредством беседы.
• Обработка изображений – Генерировать замещающий текст и анализировать изображения.
• Внешние системы – Интеграция с API, базами данных и сервисами.
• Пользовательские инструменты – Расширьте свою собственную бизнес-логику

Расширение возможностей команды

• Более низкий порог входа – Новые редакторы продуктивны с первого дня
• Встроенные лучшие практики – ИИ помогает редакторам создавать качественный контент
• Ролевой доступ – Контролируйте, кто может использовать функции искусственного интеллекта (необязательно).
• Аудиторский след – Отслеживайте все изменения с помощью ИИ

---

Предварительные условия

Перед установкой AI Chat убедитесь, что у вас есть:

• Optimizely CMS 12.18+ или Optimizely Commerce 14+
• Установлен Epicweb.Optimizely.AIAssistant 3.0+
• Ключ OpenAI API или совместимый поставщик AI (Azure OpenAI, Google Gemini) — на локальном хосте это не требуется.
• Доступ разработчика к исходному коду вашего решения
• .NET 6.0+ (или совместимая с вашей версией CMS)

---

Пошаговая установка

Шаг 1. Установите базовый пакет

Если вы еще не установили AI Assistant, начните здесь:

Через консоль диспетчера пакетов NuGet:

Install-Package Epicweb.Optimizely.AIAssistant

Или через .NET CLI:

dotnet add package Epicweb.Optimizely.AIAssistant

URL-адрес NuGet:
https://nuget.optimizely.com/package/?id=Epicweb.Optimizely.AIAssistant

---

Шаг 2. Установите пакет встроенных инструментов

Для работы AI Chat требуются инструменты. Встроенный пакет инструментов обеспечивает необходимую функциональность:

Через консоль диспетчера пакетов NuGet:

Install-Package Epicweb.Optimizely.AIAssistant.Tools

Или через .NET CLI:

dotnet add package Epicweb.Optimizely.AIAssistant.Tools

URL-адрес NuGet:
https://nuget.optimizely.com/package/?id=Epicweb.Optimizely.AIAssistant.Tools

Почему инструменты важны? Инструменты позволяют ИИ выполнять реальные операции, получать контент, обновлять свойства, публиковать страницы, а не просто генерировать текст. Без инструментов ИИ может только предлагать изменения. С помощью инструментов он действительно может их выполнять.

---

Шаг 3. Настройте службы в Startup.cs

Откройте свой Startup.cs файл и зарегистрируйте AI Assistant со всеми необходимыми пакетами инструментов:

using Epicweb.Optimizely.AIAssistant;
using Epicweb.Optimizely.AIAssistant.Tools;
using Epicweb.Optimizely.AIAssistant.Hub;

public void ConfigureServices(IServiceCollection services)
{
    // ... your existing services ...

    services
        .AddAIAssistant()
        // Register built-in tool types for AI Chat functionality
        .RegisterMcpToolType(typeof(BuiltinTools))            // Core helper tools
        .RegisterMcpToolType(typeof(BuiltinChatTools))        // Content reading
        .RegisterMcpToolType(typeof(BuiltinPublishChatTools)) // Publishing operations
        .RegisterMcpToolType(typeof(BuiltinUpdateChatTools))  // Content updates
        .RegisterMcpToolType(typeof(BuiltinChatImageTools))   // Image analysis
        .RegisterMcpToolType(typeof(BuiltinChatCreateImageTools)); // Image generation

    // ... other registrations ...
}

Распределение пакета инструментов:

Пакет инструментов	Цель	Примеры операций
BuiltinTools	Основные вспомогательные утилиты	Форматирование даты, манипуляции со строками
BuiltinChatTools	Чтение контента	Получить содержимое страницы, выполнить поиск, составить список дочерних элементов
BuiltinPublishChatTools	Издательский	Опубликовать, отменить публикацию, запланировать
BuiltinUpdateChatTools	Редактирование контента	Обновляйте свойства, создавайте черновики
BuiltinChatImageTools	Операции с изображениями	Анализируйте изображения, генерируйте замещающий текст
BuiltinChatCreateImageTools	Создание имиджа	Инструкция по созданию изображений

---

Шаг 4. Зарегистрируйте SignalR Hub

AI Chat использует SignalR для общения в режиме реального времени. Добавьте конечную точку концентратора в свой Configure метод:

using Epicweb.Optimizely.AIAssistant.Hub;

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // ... existing middleware ...

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
        endpoints.MapContent();
        endpoints.MapAIAssistantHub(); // Required for AI Chat
    });
}

Важный: Без MapAIAssistantHub()окно чата не сможет подключиться и отобразит ошибки.

---

Шаг 5. Настройте файл appsettings.json.

Добавьте конфигурацию AI Chat в свой appsettings.json:

{
  "Epicweb": {
    "AIAssistant": {
      "ApiKey": "sk-proj-your-openai-api-key-here",
      "Provider": "AzureOpenAI",
      "Model": "gpt-5.2",
      "EnableChat": true,
      "ChatRoles": [
        "AIEditors",
        "WebEditors",
        "WebAdmins",
        "CmsAdmins",
        "CmsEditors"
      ],
      "MaxToolIterations": 8
    }
  }
}

Объяснение вариантов конфигурации:

Параметр	Тип	Описание	По умолчанию
ApiKey	нить	Ваш ключ OpenAI API с https://platform.openai.com/account/api-keys.	Необходимый
Provider	нить	Поставщик ИИ: OpenAI, AzureOpenAI, Gemini	OpenAI
Model	нить	Используемая модель ИИ (см. рекомендации ниже)	gpt-5.2
EnableChat	логическое значение	Включает окно AI Chat на панели инструментов CMS.	false
ChatRoles	нить[]	Роли пользователей, которые могут получить доступ к AI Chat (необязательно, если не указано, что доступ могут получить все прошедшие проверку подлинности пользователи)	Все пользователи
MaxToolIterations	интервал	Предотвращает бесконечные циклы вызова инструментов	8

Получение вашего API-ключа

1. Перейдите на https://platform.openai.com/account/api-keys.
2. Зарегистрируйтесь или войдите
3. Нажмите «Создать новый секретный ключ».
4. Скопируйте ключ (начинается с sk-)
5. добавить в appsettings.json

Совет по безопасности: Никогда не передавайте ключи API в систему контроля версий. Использовать:

• Хранилище ключей Azure
• Переменные среды
• Секреты пользователя (dotnet user-secrets set "Epicweb:AIAssistant:ApiKey" "sk-...")

---

Шаг 6. Выберите правильную модель ИИ

Критический: Для AI Chat требуются продвинутые модели с надежными возможностями вызова инструментов.

Рекомендуемые модели

ОпенАИ:

• gpt-5.2 – Последняя, лучшая общая производительность (рекомендуется)
• gpt-5.1 – Отличная координация работы с инструментами и мышление.
• gpt-5 – Стабильная производительность при вызове инструментов
• gpt-5.5-mini – Бюджетный вариант с хорошей инструментальной поддержкой

Azure OpenAI:

• gpt-5.2 — То же, что OpenAI, но размещено в Azure.
• gpt-5.1 – Надежный корпоративный вариант

Гугл Близнецы:

• gemini-2.5-pro – Последняя стабильная версия (рекомендуется)
• gemini-2.5-flash – Более быстрый и экономичный вариант

Модели НЕ совместимы с AI Chat

• gpt-4o, gpt-4-turbo, gpt-4 – Старое поколение, несовместимый вызов инструментов
• gpt-3.5-turbo – Нет расширенной координации инструментов
• gemini-1.5-pro, gemini-1.5-flash – Старые версии Gemini не поддерживаются.

Почему выбор модели имеет значение: AI Chat использует расширенный вызов функций для выполнения нескольких инструментов в сложных последовательностях. Только модели GPT-5+ и Gemini 2.5+ обладают необходимыми возможностями для:

• Объедините несколько вызовов инструментов вместе
• Обрабатывайте ошибки и повторяйте попытки, используя разные подходы.
• Сохраняйте контекст в длинных разговорах
• Поймите, когда использовать конкретные инструменты

---

Шаг 7. Настройка доступа на основе ролей (необязательно)

По умолчанию все прошедшие проверку подлинности пользователи CMS имеют доступ к AI Chat. Чтобы ограничить доступ к определенным ролям:

Пример: разрешить только администраторам

"ChatRoles": ["CmsAdmins", "WebAdmins"]

Пример: разрешить определенные роли редактора

"ChatRoles": ["CmsEditors", "WebEditors", "AIEditors", "CmsAdmins"]

Пример: пользовательские роли

"ChatRoles": ["ContentCreators", "SEOSpecialists"]

Чтобы разрешить всем пользователям: Просто опустите ChatRoles установка или установка пустого массива:

"ChatRoles": []

Убедитесь, что пользователям назначены эти роли в интерфейсе администратора Optimizely в разделе:
Администратор -> Администрирование групп

---

Шаг 8. Проверьте установку

После завершения настройки:

1. Создайте свое решение

   dotnet build
   

2. Запустите приложение

   dotnet run
   

3. Войдите в Optimizely CMS
4. Найдите кнопку AI Chat. на панели инструментов CMS (обычно вверху справа)
5. Нажмите, чтобы открыть окно чата
6. Проверьте с помощью простой команды:

   "What tools are available?"
   

Если вы видите список инструментов, поздравляем. AI-чат работает.

Дальше

Теперь у вас установлен и подключен AI Assistant Chat, зарегистрированы нужные пакеты инструментов, включен SignalR и заданы настройки поставщика. Отсюда вы можете начать использовать чат для анализа страниц, улучшения SEO, проверки доступности и создания безопасных и проверяемых обновлений непосредственно из пользовательского интерфейса редактирования Optimizely.

Это была часть 1, посвященная установке и базовой настройке. Во второй части мы углубимся в настройку, пользовательские инструкции и специальные инструменты.

Ссылка на документацию: https://github.com/Epicweb-Optimizely/Epicweb.Optimizely.AIAssistant/

Примеры скриншотов