Formatieren Ihrer Agentnachrichten

Die Nachrichtenformatierung ermöglicht es Ihnen, das Beste aus den Agentennachrichten herauszuholen. Sie können Ihre Agent-Nachrichten so formatieren, dass sie Rich Cards als Anlagen enthalten, die interaktive Elemente wie Schaltflächen, Text und Bilder enthalten.

Formatieren von Textinhalten

Um Ihre Agentennachrichten zu formatieren, können Sie die optionale TextFormat Eigenschaft festlegen, um zu steuern, wie der Textinhalt Ihrer Agentennachricht gerendert wird.

Microsoft Teams unterstützt die folgenden Formatierungsoptionen:

Für markdownunterstützt Teams eine Teilmenge der Markdownformatierung. Für extendedmarkdownunterstützt Teams die CommonMark-Syntax zusammen mit zusätzlichen Features wie Tabellen, Aufgabenlisten, Codezäunen, mathematischen Formeln, Bildern, Erwähnungen und Zitaten. In erweitertem Markdowninhalt <at> ist das einzige unterstützte HTML-Tag.

Für die Formatierung gelten die folgenden Einschränkungen:

• Nur-Text-Nachrichten im plain Format unterstützen keine Tabellenformatierung.
• Funktionsreiche Karten unterstützen die Formatierung nur in der Texteigenschaft, nicht in den Titel- oder Untertiteleigenschaften.
• Für umfangreiche Karten werden Nutzlasteigenschaften markdown und extendedmarkdown Formatierung nicht unterstützt.
• Ältere oder nicht unterstützte Clients können nicht unterstützte Konstrukte als Nur-Text anzeigen.

Stellen Sie nach dem Formatieren von Textinhalt sicher, dass die Formatierung auf allen von Teams unterstützten Plattformen funktioniert.

Nachrichtentextformat festlegen

Um das Textformat festzulegen, geben Sie die textFormat Eigenschaft in Ihrem Activity Objekt an. Das folgende Beispiel zeigt, wie Sie eine formatierte Nachricht senden extendedmarkdown :

{
  "type": "message",
  "textFormat": "extendedmarkdown",
  "text": "### Sprint update\n\n- [x] Build completed\n- [1] Deploy pending"
}

var activity = new Activity
{
    Type = ActivityTypes.Message,
    Text = "### Sprint update\n\n- [x] Build completed\n- [1] Deploy pending",
    TextFormat = "extendedmarkdown"
};

await app.Send(conversationId, activity);

const activity = {
  type: "message",
  text: "### Sprint update\n\n- [x] Build completed\n- [1] Deploy pending",
  textFormat: "extendedmarkdown"
};

await app.send(conversationId, activity);

activity = Activity(
    type=ActivityTypes.message,
    text="### Sprint update\n\n- [x] Build completed\n- [1] Deploy pending",
    text_format="extendedmarkdown"
)

await app.send(conversation_id, activity)

Unterstützung von Standard Markdown

Einige Formatvorlagen werden nicht auf allen Plattformen unterstützt. Die folgende Tabelle enthält eine Liste der Markdown-Standardformatvorlagen und welche dieser Formatvorlagen in Nur-Text-Nachrichten und Rich Cards unterstützt werden:

Erweiterte Markdown-Funktionen

Bei Verwendung textFormat: "extendedmarkdown"sind die folgenden Funktionen in reinen Textnachrichten verfügbar:

Unterstützung bei der Erwähnung

Erwähnen Sie Benutzer und Gruppen in Ihren Agentnachrichten. Erwähnungen funktionieren sowohl mit standardmäßigem als auch mit erweitertem Markdown:

Hello <at>Jane Smith</at>, please review this.

Notifying team: <at>Engineering Team</at>

Eingezäunte Codeblöcke

Verwenden Sie dreifache Backticks mit einem Sprachbezeichner, um syntaxhervorgehobenen Code in Ihren Agent-Nachrichten anzuzeigen.

```python
def fibonacci(n):
    if n <= 1:
        return n
    return fibonacci(n-1) + fibonacci(n-2)
```

Mathematische Formeln

Verwenden Sie die LaTeX/KaTeX-Syntax zum Rendern der mathematischen Notation. Verwenden Sie einfache Dollarzeichen für Inlinegleichungen und doppelte Dollarzeichen für Blockgleichungen.

Inline math: $E = mc^2$

Block math:
$$
\int_0^\infty f(x)dx
$$

Bilder

Verwenden Sie die Standard-Markdownbildsyntax, um Bilder in Ihren Agentennachrichten zu rendern.

![Build status](https://example.com/build-status.png)

Zitate

Zitieren Sie Quellen in Ihren Agent-Nachrichten mithilfe [#] der Notation im Nachrichtentext und geben Sie Details zum Zitat im Aktivitätsarray entities an. Weitere Informationen zum Hinzufügen von Zitaten finden Sie unter Zitate.

Tabellen

Verwenden Sie die Tabellensyntax von GitHub Flavored Markdown (GFM), um strukturierte Daten darzustellen. Tabellen unterstützen die Spaltenausrichtung mithilfe von Doppelpunkten in der Trennzeile.

| Feature | Status | Priority |
|:--------|:------:|----------:|
| Tables  | Done   | High      |
| Math    | Done   | High      |

In diesem Beispiel ist die erste Spalte linksbündig, die zweite zentriert und die dritte rechtsbündig ausgerichtet.

Aufgabenlisten

Verwenden Sie die Syntax von Aufgabenlisten, um abgeschlossene und ausstehende Elemente in Ihren Agent-Nachrichten anzuzeigen.

- [x] Checkout code
- [x] Install dependencies
- [x] Run unit tests
- [ ] Deploy to production

Streaming mit erweitertem Markdown

Erweiterte Markdowninhalte werden während des Streamings gerendert:

• Eingezäunte Codeblöcke: Rendern nur, nachdem der schließende ``` Zaun in seiner eigenen Zeile empfangen wurde
• Mathematische Formeln: Rendern, nachdem das Schließen $ oder $$ Trennzeichen empfangen wurde
• Bilder und Bild-URLs: Das Rendern nach der schließenden Klammer der Bild-URL hat die Überprüfung bestanden
• Erwähnungen: Rendern, wenn <at>...</at> Tags vollständig und gültig sind
• Zitate: Rendern, wenn [#] Markierungen und entsprechende entities Elemente in der Aktivität vorhanden sind
• Tabellen: Rendern, wenn genügend Zeilen empfangen werden, um eine gültige Tabellenstruktur zu bilden
• Aufgabenlisten: Rendern, wenn Listenelemente und Kontrollkästchenmarkierungen (- [ ], - [x]) abgeschlossen sind

Ausführliche Informationen zur Streamingimplementierung finden Sie unter Stream von Agent-Nachrichten.

Unterstützung durch einzelne Plattform

Die Unterstützung der Textformatierung variiert je nach Nachrichtentyp und Plattform.

Nur-Text-Nachrichten

Die folgende Tabelle enthält eine Liste der Formatvorlagen, die unter Desktop, iOS und Android unterstützt werden:

KI-generierte Inhaltsnachrichten

KI-Bezeichnungen, Zitate, Feedback-Schaltflächen und Vertraulichkeitsbezeichnungen in den Nachrichten Ihres Agenten verbessern die Benutzerbindung und fördern Transparenz und Vertrauen.

• Mit der KI-Bezeichnung können Benutzer erkennen, dass die Nachricht mithilfe von KI generiert wurde.
• Mit Zitaten können Benutzer über In-Text-Zitate und Verweise auf die Quelle der Nachricht des Agenten verweisen.
• Mit den Schaltfläche "Feedback" können Benutzer positives oder negatives Feedback zu den Nachrichten des Agents geben.
• Mit der Vertraulichkeitsbezeichnung können Benutzer die Vertraulichkeit der Nachricht des Agenten verstehen.

Weitere Informationen finden Sie unter Agent-Nachrichten mit KI-generiertem Inhalt.

Nächster Schritt

Siehe auch

• Erstellen von Agents für Teams
• Adaptive Karten
• Formatieren von Karten in Microsoft Teams