Inhalte adaptiver Karten lokalisieren

Mit Adaptiven Karten können sie Ihren Copilot Studio-Nutzern reichhaltige, strukturierte Informationen präsentieren. Für mehrsprachige Agenten sollten Sie sowohl Ihren Themeninhalt als auch den Text der Adaptiven Karte vollständig lokalisieren. Durch die Verwendung von adaptiven Karten können Sie eine einfache Oberfläche für alle wichtigen Plattformen und Frameworks entwerfen und integrieren.

Copilot Studio unterstützt die Lokalisierung statischer Texte in Adaptiven Karten über dieselben JSON/ResX-Lokalisierungsdateien, die Sie bereits für Themen verwenden.

Dieser Artikel erklärt den Lokalisierungs-Workflow, wie man Adaptiven Karten-Text übersetzt und wie man mit gemischten Inhalten umgeht, die sowohl statische als auch dynamische Werte enthalten.

Bevor Sie beginnen

Sie müssen mit den folgenden Konzepten vertraut sein:

Lokalisierungs-Workflows verstehen

Copilot Studio enthält den gesamten statischen Text der Adaptiven Karte in Ihren exportierten Lokalisierungsdateien. Dieser Text enthält:

  • TextBlock-Werte
  • Schaltflächentitel
  • Platzhaltertext
  • Fehlermeldungen
  • Alternativer Bildtext

Sie können sämtliche benutzergerichteten Inhalte in Themen und Adaptive Karten durch einen einheitlichen Übersetzungsworkflow übersetzen.

Wie statischer Text der adaptiven Karte in Lokalisierungsdateien erscheint

Wenn Sie eine Lokalisierungsdatei für eine weitere Sprache exportieren, erscheinen die statischen „Karten“-Texte als Einträge neben Ihren „Thema“-Zeichenfolgen.

Jeder Eintrag enthält einen eindeutigen Schlüsselpfad, der angibt, wo sich der Text in der Dialog-, Themen- und Kartenstruktur befindet. Obwohl die Schlüssel ausführlich sind, müssen Sie nur die Werte übersetzen.

Beispiel (gekürzt):

{
  "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"
}

Umgang mit Zeichenfolgenketten mit gemischtem Inhalt mit SetTextVariable

Einige Zeichenfolgenketten in adaptiven Karten enthalten eine Kombination aus statischem Text und dynamischen Werten. Zum Beispiel:

Sie genehmigen den Antrag PR-20417 in Höhe von 1.245,80 $ für Contoso Research

Die Antrags-ID, der Gesamtbetrag und die Geschäftseinheit sind Variablen. Der umgebende Text muss übersetzt werden. Copilot Studio kann statischen Text aus gemischten Inhalten nicht automatisch extrahieren, sodass diese Werte nicht in der Lokalisierungsdatei erscheinen.

Verwenden Sie den „Textvariable festlegen“-Knoten zur Lokalisierung gemischter Inhalte

Copilot Studio enthält den Knoten Textvariablen festlegen, der nur über den Code-Editor verfügbar ist. Mit diesem Knoten können Sie:

  • Kombinieren Sie statischen Text mit variablen Platzhaltern.
  • Erzeugen Sie eine einzige Zeichenfolge, die in Lokalisierungsdateien erscheint.
  • Bewahren Sie die Struktur der Variablen während der Übersetzung.

Erfahren Sie mehr unter Dynamische Inhalte von Adaptive Karten für die Lokalisierung verfügbar machen.

Exportieren Sie Ihre Lokalisierungsdatei und übersetzen Sie den statischen Text

Wenn Sie die Lokalisierungsdatei herunterladen, enthält sie die vollständige gemischte Zeichenfolge mit Platzhaltern.

Zum Beispiel:

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

Übersetzen Sie nur den statischen Text und lasse die variablen Platzhalter unverändert.

Wichtige Erkenntnisse

  • Statischer Text der adaptiven Karte erscheint in Lokalisierungsdateien, sodass Sie alle benutzerorientierten Inhalte konsistent übersetzen können.
  • Adaptive Karten benötigen nicht mehrere Versionen oder bedingte Ausdrucksformen für mehrsprachige Erfahrungen.
  • Verwenden Sie einen Knoten Textvariable festlegen für gemischte statische und dynamische Inhalte, um die vollständige Lokalisierung von Platzhaltern und umgebendem Text zu gewährleisten.

Dieser einheitliche Workflow vereinfacht den Lokalisierungsprozess und erleichtert die Erstellung globaler Benutzererfahrungen in Copilot Studio.

  • Last updated on