Тональность бренда задаёт, как говорит ваш продукт: стиль, формальность, регистр — один текст для каждой целевой локали. Это объект уровня организации: именованный контейнер с вариацией для каждой нужной локали, который подключается к движку локализации.
Один голос — много локалей
Раньше тональность бренда была текстом для одной локали и принадлежала одному движку. Теперь это один голос с текстом для каждой локали. Движки, у которых была отдельная тональность на каждую локаль, объединены в один голос с вариацией на локаль — все локали и тексты остались на своих местах.
Как это работает#
| Объект | Поля |
|---|---|
| Тональность бренда | Название, описание. Хранит один текст для каждой целевой локали. |
| Вариация | Целевая локаль (или *), текст голоса. |
Когда движок обрабатывает запрос для целевой локали, он находит одну наиболее подходящую вариацию среди всех подключённых голосов и включает этот текст в промпт LLM — задавая выбор слов, структуру предложений и регистр.
На каждый запрос применяется ровно один текст тональности бренда. Правила и термины глоссария объединяются, тональности бренда — нет.
| Поле | Описание |
|---|---|
| Целевая локаль | Локаль, к которой применяется текст (например, de, fr-CA, ja), или * для любой локали |
| Текст тональности | Произвольные инструкции с описанием тональности, формальности и стиля для этой локали |
Один голос на локаль на движок#
Движок читает одну тональность бренда для локали. Три ограничения это гарантируют:
| Действие | Результат |
|---|---|
Подключить два голоса, оба с текстом для de | Отказ (400) с указанием пересекающихся локалей |
Добавить текст для de в голос, когда другой голос на том же движке уже охватывает de | Отказ (409) |
Добавить второй текст для de в тот же голос | Отказ (409) — голос хранит один текст на локаль |
Вариация * — запасной вариант для локалей без собственного текста. Текст для конкретной локали всегда имеет приоритет; региональное разрешение работает как обычно: текст для de-DE отвечает на запрос просто de. См. Разрешение локали.
Тональности бренда принадлежат организации#
| Действие | Результат |
|---|---|
| Создать тональность бренда | Создаётся на уровне организации и не применяется нигде, пока не подключена |
| Подключить к движку | Каждая вариация применяется к соответствующим локалям этого движка |
| Подключить к нескольким движкам | Один голос управляет всеми — измените один раз, все движки подхватят изменение |
| Подключить несколько голосов к одному движку | Разрешено, если никакие два голоса не охватывают одну и ту же локаль |
| Отключить от движка | Движок перестаёт применять голос. Голос и его вариации сохраняются. |
| Удалить тональность бренда | Отказ, пока хотя бы один движок её применяет — сначала отключите. При удалении вариации тоже удаляются. |
| Удалить движок | Тональности бренда сохраняются — они принадлежат организации, а не движку. |
Управляйте голосами в разделе Тональности бренда на боковой панели организации: список показывает, сколько локалей охватывает каждый голос и сколько движков его используют; страница голоса содержит тексты по локалям. Вкладка Тональность бренда движка показывает по одной строке на локаль и позволяет отключать голоса целиком.
Как написать текст тональности бренда#
Текст голоса — свободный текст на естественном языке. Пишите его так, как если бы инструктировали переводчика, который никогда не работал с вашим продуктом.
Эффективная тональность бренда включает:
- Уровень формальности — формальное "Sie" или неформальное "du" в немецком, "vous" или "tu" во французском
- Тон — профессиональный, разговорный, игривый, технический
- Аудитория — разработчики, корпоративные заказчики, потребители, внутренние команды
- Правила — как передавать числа, даты, валюту и терминологию, специфичную для продукта
Пример#
Для немецкой локали с аудиторией разработчиков:
Use informal "du" address. Keep a direct, technical tone - similar
to how Stripe or Vercel write their German documentation. Prefer
short sentences. Use active voice. When a German equivalent exists
for a technical term, use it (e.g., "Bereitstellung" for deployment),
but keep widely-adopted English terms as-is (e.g., API, CLI, Token).Название и описание контейнера — для людей: они помогают найти голос в списке организации и понять, для чего он. До модели доходит только текст вариации.
Использование тональности бренда с API#
Тональности бренда применяются автоматически при вызове эндпоинта локализации. Движок сопоставляет targetLocale запроса с вариациями всех подключённых голосов и включает наиболее подходящую в промпт. Дополнительные параметры не нужны.
{
"sourceLocale": "en",
"targetLocale": "de",
"data": {
"greeting": "Hey there! Ready to ship?",
"cta": "Get started"
}
}С приведённым немецким текстом движок выдаёт неформальные, технически ориентированные переводы вместо стандартного официального.
| Вызов | Назначение |
|---|---|
POST /brand-voices | Создать голос для организации |
GET /organizations/:id/brand-voices | Получить список голосов организации с количеством локалей и движков |
GET /brand-voices/:id/variations | Получить тексты голоса по локалям |
POST /brand-voice-variations с brandVoiceId | Добавить текст для одной локали |
PUT /brand-voice-variations/:id | Изменить текст или перенести его в другую локаль |
PUT /engines/:id/brand-voices | Заменить набор голосов, применяемых движком |
DELETE /engines/:id/brand-voices/:brandVoiceId | Отключить один голос от движка |
GET /engines/:id/brand-voice-variations | Получить все тексты локалей, которые движок применяет сейчас |
POST /brand-voices по-прежнему принимает targetLocale и text вместе и создаёт первую вариацию голоса; ownerEngineId по-прежнему добавляет к голосу, который движок уже применяет, — создавая и подключая новый, если голоса ещё нет.
Доступ#
org:brandvoice:read и org:brandvoice:edit управляют голосами и их вариациями; чтобы подключить голос к движку, нужно также engine:edit на этот движок. Доступ к отдельному голосу даёт право читать и редактировать только его, а не все голоса организации. См. Роли и разрешения.
Управление тональностью бренда через MCP#
Если вы используете Lingo.dev MCP server, ваш AI-помощник для разработки сможет создавать и обновлять тональности бренда прямо в ходе диалога:
"Create a brand voice called Product voice and apply it to the
docs engine.""Set its German text to informal du, technical tone, short
sentences, active voice."