Адаптивна картка кількома мовами в Copilot Studio: одна картка, польська й англійська

Як зробити в Copilot Studio одну адаптивну картку, яка показується польською, англійською чи німецькою: файл локалізації, переклад текстів і обхідний шлях для текстів зі змінними.
У компанії з філіями в кількох країнах агент мусить говорити кількома мовами. З текстовими відповідями Copilot Studio справляється добре, але адаптивні картки (форми, кнопки, підсумки) довгий час доводилося робити окремо для кожної мови. Тепер можна побудувати одну картку, а переклади зберігати у файлі локалізації.
Опис ґрунтується на записі команди Microsoft CAT. Він стосується класичного (standard) harness, у якому картки будують у темах. Різниці ми описуємо в статті Microsoft Copilot harness чи standard.
Крок 1: побудуйте картку з текстом однією мовою
Впишіть тексти безпосередньо в картку: заголовки (TextBlock), назви кнопок, альтернативні тексти й fallbackText. Такі сталі тексти автоматично потрапляють до файлу локалізації агента.
Крок 2: завантажте файл локалізації
Завантажте файл локалізації агента (JSON або ResX). Кожен текст із картки має там окремий запис. Ключі довгі, бо містять увесь шлях до елемента картки. Перекладайте лише значення, ключів не чіпайте.
Тут знадобиться ШІ. Файл можна перекласти із запитом:
Переклади польською лише значення в цьому файлі JSON. Не змінюй ключів і нічого у фігурних дужках. Збережи структуру файлу.
Перед завантаженням перевірте переклад, особливо назви кнопок і фірмові терміни.
Крок 3: завантажте перекладений файл
Після завантаження файлу користувачі бачать картку своєю мовою.
Тексти зі змінними: обхідний шлях
Проблема з’являється з текстами на кшталт «Strona 2 z 5» («Сторінка 2 з 5»), де сталий текст поєднується зі змінною. Такі тексти не потрапляють самі до файлу локалізації. Обхідний шлях:
- Перед карткою додайте вузол встановлення змінної (Set variable value).
- У редакторі коду змініть у ньому
kind: SetVariableнаkind: SetTextVariable. - Впишіть речення з місцями для змінних, напр.
Strona {Topic.currentPage} z {Topic.totalPages}. - У картці використайте цю змінну замість склеювання тексту на місці.
- У файлі локалізації перекладіть речення, залишивши фігурні дужки без змін.
Вузол Set text variable можна створити лише в редакторі коду, не на полотні.
Чому це краще за старі способи
Раніше робили окрему картку для кожної мови або підміняли тексти в Power Fx залежно від мови. Кожна зміна в картці означала виправлення в кількох місцях. Тепер ви змінюєте картку один раз, а переклади оновлюєте у файлі.
Якщо картку після надсилання можна надіслати вдруге, дивіться, як її заблокувати в Teams. Про переклад листів і документів із ШІ пишемо в статті про листи англійською й німецькою з ШІ.
Дивіться також: Агент Copilot Studio відповідає англійською замість польської? 7 причин і рішення
Джерела і дата перевірки
Станом на 13 листопада 2026 р..
- записі команди Microsoft CAT (microsoft.github.io)
Ціни, функції інструментів і закони можуть змінитися після цієї дати, тож перед важливими рішеннями перевірте актуальний стан у джерелі.