Lokalizowanie zawartości karty adaptacyjnej

Dotyczy tylko:Standardowa uprząż

Za pomocą kart adaptacyjnych można prezentować użytkownikom agentów Copilot Studio rozbudowane, ustrukturyzowane informacje. W przypadku agentów wielojęzycznych pamiętaj, aby w pełni zlokalizować zawartość tematu i tekst karty adaptacyjnej. Korzystając z Adaptive Cards, można projektować i integrować uproszczony interfejs użytkownika dla wszystkich głównych platform i struktur.

Copilot Studio obsługuje lokalizację tekstu statycznego w kartach adaptacyjnych za pomocą tych samych plików lokalizacji JSON/ResX, których już używasz w tematach.

W tym artykule wyjaśniono przepływ pracy lokalizacji, sposób tłumaczenia tekstu karty adaptacyjnej oraz sposób obsługi mieszanej zawartości zawierającej zarówno wartości statyczne, jak i dynamiczne.

Przed rozpoczęciem

Zapoznaj się z następującymi pojęciami:

Zrozumienie procesów lokalizacyjnych

Program Copilot Studio zawiera cały statyczny tekst karty adaptacyjnej w wyeksportowanych plikach lokalizacji. Ten tekst obejmuje:

  • TextBlock wartości
  • Tytuły przycisków
  • Tekst zastępczy
  • Komunikaty o błędach
  • Tekst alternatywny obrazu

Wszystkie teksty dostępne dla użytkownika można przetłumaczyć w tematach i kartach adaptacyjnych za pomocą jednego przepływu pracy tłumaczenia.

Jak statyczny tekst karty adaptacyjnej jest wyświetlany w plikach lokalizacji

Podczas eksportowania pliku lokalizacji dla dowolnego języka pomocniczego tekst karty statycznej jest wyświetlany jako wpisy obok ciągów tematu.

Każdy wpis zawiera unikatową ścieżkę klucza, która identyfikuje miejsce, w którym tekst istnieje w oknie dialogowym, temacie i strukturze karty. Mimo że klucze są rozbudowane, wystarczy przetłumaczyć wartości.

Przykład (obcięty):

{
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[0].text": "Purchase request",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[2].columns[0].items[0].text": "Requested by",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[2].columns[1].items[0].text": "Department",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[3].facts[0].title": "Request ID",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.body[3].facts[1].title": "Total",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.actions[0].title": "Approve",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.actions[1].title": "Reject",
  "dialog(procurement_flow).topic.purchaseApproval.trigger(manager_route).action(showApprovalCard).card.actions[2].title": "View details"
}

Obsługa ciągów mieszanych zawartości za pomocą zmiennej SetTextVariable

Niektóre ciągi w kartach adaptacyjnych zawierają kombinację statycznego tekstu i wartości dynamicznych. Na przykład:

Zatwierdzasz wniosek PR‑20417 na łączną kwotę 1245,80 USD dla firmy Contoso Research.

Identyfikator żądania, łączna kwota i jednostka biznesowa są zmiennymi. Otaczający tekst wymaga tłumaczenia. Program Copilot Studio nie może automatycznie wyodrębnić tekstu statycznego z zawartości mieszanej, więc te wartości nie są wyświetlane w pliku lokalizacji.

Używanie węzła Ustaw zmienną tekstową na potrzeby lokalizowanej zawartości mieszanej

Program Copilot Studio zawiera węzeł Ustaw zmienną tekstową , dostępny tylko za pośrednictwem edytora kodu. Ten węzeł umożliwia:

  • Połącz tekst statyczny i zmienne symbole zastępcze.
  • Utwórz pojedynczy ciąg, który pojawi się w plikach lokalizacji.
  • Zachowaj strukturę zmiennych podczas tłumaczenia.

Dowiedz się więcej w artykule Udostępnianie zawartości dynamicznej z kart adaptacyjnych na potrzeby lokalizacji.

Eksportowanie pliku lokalizacji i tłumaczenie tekstu statycznego

Po pobraniu pliku lokalizacji zawiera on pełny ciąg zawartości mieszanej z symbolami zastępczymi.

Na przykład:

{
  "'dialog(copilots_header_392e9.topic.recommendbooks)'.'trigger(main)'.'action(readingProgress)'.Value":
    "You are approving request {Topic.requestId} totaling {Topic.formattedTotal} for {Topic.businessUnit}"
}

Przetłumacz tylko tekst statyczny i zachowaj zastępcze miejsca zmiennych bez zmian.

Podjąć klucza

  • Statyczny tekst karty adaptacyjnej jest wyświetlany w plikach lokalizacji, dzięki czemu można spójnie tłumaczyć całą zawartość skierowaną do użytkownika.
  • Karty adaptacyjne nie wymagają wielu wersji ani wyrażeń warunkowych dla środowisk wielojęzycznych.
  • Użyj węzła Ustaw zmienną tekstową dla zawartości mieszanej: statycznej i dynamicznej, aby mieć pewność, że symbole zastępcze oraz tekst otaczający są w pełni lokalizowane.

Ten ujednolicony przepływ pracy upraszcza proces lokalizacji i ułatwia tworzenie środowisk użytkownika gotowych do użycia w aplikacji Copilot Studio.

  • Ostatnia aktualizacja o