Verbessern von KI-generierten Agent-Nachrichten

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

• Mithilfe der KI-Bezeichnung können Benutzer erkennen, dass die Nachricht mithilfe von KI generiert wurde.
• Zitate ermöglichen Es Benutzern, durch In-Text-Zitate und Verweise auf die Quelle der Agent-Nachricht zu verweisen.
• Mithilfe von Feedbackschaltflächen können Benutzer positives oder negatives Feedback zu den Agent-Nachrichten geben.
• Vertraulichkeitsbezeichnung ermöglicht Benutzern, die Vertraulichkeit der Agent-Nachricht zu verstehen.

Die folgenden Screenshots zeigen, wie Agent-Nachrichten mit KI-Bezeichnung, Zitat, Feedbackschaltflächen und Vertraulichkeitsbezeichnung verbessert werden können:

KI-Bezeichnung

Eine KI-Bezeichnung in Ihrer Agent-Nachricht gibt an, dass sie von KI generiert wird. Ki-gestützte Agents, die große Sprachmodelle (Large Language Models, LLMs) verwenden, sind zwar im Allgemeinen zuverlässig, aber die Bezeichnung trägt dazu bei, Verwechslungen über die Quelle der Informationen zu vermeiden.

Ki-Bezeichnung hinzufügen

Um Ihren Agent mit dem Teams SDK zu erstellen, verwenden Sie die addAiGenerated() -Methode, um eine Nachricht als KI-generiert zu markieren. Der folgende Codeausschnitt zeigt, wie die KI-Bezeichnung in einer Agent-Nachricht aktiviert wird:

app.message(/label/i, async ({ send }) => {
  await send(new MessageActivity("Hi, this message is generated by AI").addAiGenerated());
});

async Task SendAILabel(IContext context)
{
    await context.Send(new MessageActivity
    {
        Text = "Hi, this message is generated by AI"
    }.AddAIGenerated());
}

@app.on_message_pattern(re.compile(r"label", re.IGNORECASE))
async def add_ai_label(ctx: ActivityContext[MessageActivity]):
    await ctx.send(
        MessageActivityInput(
            text="Hi, this message is generated by AI",
        ).add_ai_generated()
    )

Nachdem Sie eine KI-Bezeichnung hinzugefügt haben, wird in der Meldung Ihres Agents neben dem Namen des Agents eine VON KI generierte Bezeichnung angezeigt. Wenn Sie mit dem Mauszeiger auf die KI-Bezeichnung zeigen, wird ein Haftungsausschluss angezeigt, der besagt, dass KI-generierte Inhalte möglicherweise falsch sind. Die KI-Bezeichnung und der Haftungsausschluss können nicht für KI-gestützte Agents angepasst werden.

Fehlerbehandlung

Zitate

Das Zitieren von Quellen in Agent-Nachrichten hilft Benutzern, Folgefragen zu stellen oder unabhängige Recherchen durchzuführen. Zitieren Sie Datenquellen wie Dateien, Nachrichten, E-Mails und Arbeitselemente, um wertvolle Erkenntnisse zu liefern. Zitate sind für Agents, die Techniken wie Retrieval-Augmented Generation (RAG) verwenden, von entscheidender Bedeutung.

Zitate in den Nachrichten Ihres Agents können Folgendes enthalten:

• In-Text-Zitate bezeichnen die Zitatnummern, die der Agent-Nachricht im [#]-Format hinzugefügt wurden, die jeweils einem Verweis entsprechen. Ein Zitat kann an einer beliebigen Stelle innerhalb des Texts eingefügt werden.
• Zu den Details der Zitatreferenz gehören Titel, Symbol, Schlüsselwörter, Abstract, Hyperlink, Vertraulichkeitsinformationen und eine Schaltfläche zum Öffnen eines modales Fensters mit zusätzlichem Inhalt. Verweise werden als Popupfenster für jedes In-Text-Zitat angezeigt.
• Vertraulichkeitsbezeichnungen für Zitate geben die Vertraulichkeit des Zitatinhalts an, auf den verwiesen wird, und werden nicht automatisch hinzugefügt. Informationen zum Hinzufügen von Vertraulichkeitsbezeichnungen für Zitate finden Sie unter Hinzufügen von Vertraulichkeitsbezeichnungen.
• Ein modales Fenster mit zusätzlichem Inhalt rendert eine adaptive Karte ohne interaktive Elemente.

Zitate hinzufügen

Wenn Sie das Teams SDK zum Erstellen Ihres Agents verwenden, verwenden Sie addCitation() , um In-Text-Verweise und Zitatmetadaten in Ihre Nachricht einzuschließen. Es folgt ein Beispielcodeausschnitt:

app.message(/citation/i, async ({ send }) => {
  const card = new AdaptiveCard(new TextBlock("Adaptive Card text"))
    .withOptions({ version: "1.6" });
  const appearance: CitationAppearance = {
    name: "AI messages agent",
    url: "https://example.com/claim-1",
    abstract: "Excerpt description",
    text: JSON.stringify(card),
    keywords: ["keyword 1", "keyword 2", "keyword 3"],
    icon: "Microsoft Word",
  };
  await send(
    new MessageActivity("Hey I'm a friendly AI agent. This message is generated through AI [1]")
      .addCitation(1, appearance)
  );
});

async Task SendCitations(IContext context)
{
var message = new MessageActivity
{
Text = "Hey I'm a friendly AI agent. This message is generated through AI [1]"
};

message.AddCitation(1, new CitationAppearance
{
    Name = "AI messages agent",
    Url = "https://example.com/claim-1",
    Abstract = "Excerpt description",
    Keywords = new List<string> { "keyword 1", "keyword 2", "keyword 3" },
    Icon = CitationIcon.MicrosoftWord
});

await context.Send(message);
}

@app.on_message_pattern(re.compile(r"citation", re.IGNORECASE))
async def add_citations(ctx: ActivityContext[MessageActivity]):
    await ctx.send(
        MessageActivityInput(
            text="Hey I'm a friendly AI agent. This message is generated through AI [1]",
        ).add_citation(
            position=1,
            appearance=CitationAppearance(
                name="AI messages agent",
                url="https://example.com/claim-1",
                abstract="Excerpt description",
                text=AdaptiveCard(version="1.6", body=[TextBlock(text="Adaptive Card text")]).model_dump_json(by_alias=True, exclude_none=True),
                keywords=["keyword 1", "keyword 2", "keyword 3"],
                icon=CitationIconName.MICROSOFT_WORD,
            ),
        )
    )

Nachdem Sie Zitate aktiviert haben, enthält die Agent-Nachricht In-Text-Zitate und Verweise. Die In-Text-Zitate zeigen die Verweisdetails an, wenn Benutzer mit dem Mauszeiger auf das Zitat zeigen.

Fehlerbehandlung

Feedbackschaltflächen

Feedbackschaltflächen in Agent-Nachrichten sind wichtig, um die Benutzerbindung nachzuverfolgen, Fehler zu identifizieren und Einblicke in die Agent-Leistung zu erhalten. Diese Erkenntnisse ermöglichen gezielte Verbesserungen der Konversationsfunktionen des Agents. Aktivieren Sie Feedbackschaltflächen, damit Benutzer Nachrichten mit "Gefällt mir" mögen oder nicht mögen und detailliertes Feedback geben können.

Wenn der Benutzer eine Feedbackschaltfläche auswählt, wird basierend auf der Auswahl des Benutzers ein Feedbackformular angezeigt. Sie können entweder das Standardfeedbackformular verwenden oder es an die Anforderungen Ihrer App anpassen.

Feedbackschaltflächen befinden sich in der Fußzeile der Nachricht des Agents und enthalten eine 👍 (Daumen nach oben) und eine 👎 Schaltfläche (Daumen nach unten), die der Benutzer auswählt.

Schaltflächen zum Hinzufügen von Feedback

Um Feedbackschaltflächen in einem Agent zu aktivieren, der mit dem Teams SDK erstellt wurde, verwenden Sie die addFeedback() -Methode für die Nachrichtenaktivität.

app.message(/feedback/i, async ({ send }) => { 

  await send(new MessageActivity("This is an example of a feedback button - this helps to provide feedback for a message").addFeedback()); 

}); 

async Task SendFeedbackButtons(IContext context)
{
await context.Send(new MessageActivity("This is an example of a feedback button - this helps to provide feedback for a message")
.AddFeedback());
}

@app.on_message_pattern(re.compile(r"feedback", re.IGNORECASE))
async def add_feedback_buttons(ctx: ActivityContext[MessageActivity]):
await ctx.send(
MessageActivityInput(
text="This is an example of a feedback button - this helps to provide feedback for a message",
).add_feedback('custom')
)

Wenn Sie auf defaultfestlegenfeedbackLoop.type, wird das Standardfeedbackformular angezeigt, wenn ein Benutzer die Feedbackschaltflächen auswählt. Wenn Sie ein benutzerdefiniertes Feedbackformular anzeigen möchten, legen Sie auf fest feedbackLoop.typecustom. Die folgende Aufrufanforderung wird an den Agent gesendet, um ein benutzerdefiniertes Formular abzurufen, das dem Benutzer angezeigt wird:

{
    "type": "invoke",
    "name": "message/fetchTask",
    "value": {
        "actionName": "feedback",
        "actionValue": {
            "reaction": "like" // like or dislike
        }
    }
}

Sie müssen auf diesen Aufruf mit einem Dialog (in TeamsJS v1.x als Aufgabenmodule bezeichnet) reagieren, genauso wie Sie auf einen task/fetch Aufruf reagieren würden. Weitere Informationen zum Aufrufen von Dialogen in Agents finden Sie unter Verwenden von Dialogen mit Bots.

Verarbeiten von Feedback

Der Agent empfängt Benutzereingaben aus dem Feedbackformular über einen Agent-Aufrufflow. Für Agents, die mit dem Teams SDK erstellt wurden, wird die Agent-Aufrufanforderung automatisch verarbeitet. Verarbeiten von Benutzerfeedback mithilfe des -Ereignisses message.submit.feedback .

app.on("message.submit.feedback", async (context) => { 
  // custom logic here... 
}); 

Wenn ein Benutzer Ihren Agent deinstalliert und weiterhin Zugriff auf den Agent-Chat hat, entfernt Teams die Feedbackschaltflächen aus den Agent-Nachrichten, um zu verhindern, dass der Benutzer Feedback an den Agent senden kann.

Fehlerbehandlung

Vertraulichkeitsbezeichnung

Agentantworten können vertrauliche Informationen enthalten oder nur für bestimmte Personen innerhalb der organization zugänglich sein. Fügen Sie eine Vertraulichkeitsbezeichnung hinzu, um Benutzern zu helfen, die Vertraulichkeit einer Nachricht zu identifizieren, sodass sie bei der Freigabe vorsichtshalber vorgehen können.

Vertraulichkeitsbezeichnung hinzufügen

Für Agents, die mit dem Teams SDK erstellt wurden, fügen Sie Ihrer Agent-Nachricht eine Vertraulichkeitsbezeichnung hinzu, indem Sie die Nachricht so ändern, dass sie in das entities -Objekt aufgenommen wirdusageInfo.

Der folgende Codeausschnitt zeigt, wie Sie Vertraulichkeitsbezeichnungen sowohl zu Agent-Nachrichten als auch zu Zitaten hinzufügen:

await context.sendActivity({
  type: ActivityTypes.Message,
  text: `Hey, I'm a friendly AI agent. This message is generated through AI [1]`,
  entities: [
    {
      type: "https://schema.org/Message",
      "@type": "Message",
      "@context": "https://schema.org",
      usageInfo: {
        "@type": "CreativeWork",
        name: "Sensitivity title",
        description: "Sensitivity description",
      },
    },
  ],
});

await context.sendActivity({
  type: ActivityTypes.Message,
  text: `Hey, I'm a friendly AI agent. This message is generated through AI [1]`,
  entities: [
    {
      type: "https://schema.org/Message",
      "@type": "Message",
      "@context": "https://schema.org",
      usageInfo: {
        "@type": "CreativeWork",
        name: "Sensitivity title",
        description: "Sensitivity description",
      },
      citation: [
        {
          "@type": "Claim",
          position: 1,
          appearance: {
            "@type": "DigitalDocument",
            name: "AI agent",
            url: "https://example.com/claim-1",
            usageInfo: {
              "@type": "CreativeWork",
              "@id": "sensitivity1",
              name: "Sensitivity title",
              description: "Sensitivity description",
            },
          },
        },
      ],
    },
  ],
});

Nachdem Sie die Vertraulichkeitsbezeichnung hinzugefügt haben, wird in ihrer Agent-Nachricht ein Schildsymbol angezeigt. Benutzer können mit dem Mauszeiger auf das Symbol zeigen, um einen Haftungsausschluss zur Vertraulichkeit der Nachricht anzuzeigen.

Fehlerbehandlung

Codebeispiel

Siehe auch

• Formatieren von Agent-Nachrichten
• Erste Schritte mit dem Teams SDK
• Stream-Agent-Nachrichten