Ειδοποίηση αντιπροσώπων

Σημαντικό

Πρέπει να είστε μέρος του προγράμματος προεπισκόπησης Σύνορα για να αποκτήσετε πρώιμη πρόσβαση στον Παράγοντα Microsoft 365. Η Frontier σάς συνδέει απευθείας με τις τελευταίες καινοτομίες τεχνητής νοημοσύνης της Microsoft. Οι προεπισκοπήσεις για τα σύνορα υπόκεινται στους υφιστάμενους όρους προεπισκόπησης των συμβάσεων πελατών σας. Καθώς αυτές οι δυνατότητες είναι ακόμα σε εξέλιξη, η διαθεσιμότητά τους και οι δυνατότητές τους ενδέχεται να αλλάξουν με την πάροδο του χρόνου.

Η εκπαιδευτική ενότητα Ειδοποιήσεις επιτρέπει στους προγραμματιστές να δημιουργούν παράγοντες που μπορούν να ανταποκρίνονται σε συμβάντα και ειδοποιήσεις από εφαρμογές του Microsoft 365. Με την υποστήριξη ειδοποιήσεων, οι υπάλληλοι μπορούν να λαμβάνουν και να επεξεργάζονται ειδοποιήσεις όταν οι χρήστες αλληλεπιδρούν μαζί τους μέσω ηλεκτρονικού ταχυδρομείου, εγγράφων σχολίων ή άλλων σεναρίων συνεργασίας.

Ροή εργασιών ειδοποιήσεων

Ακολουθήστε αυτήν τη ροή εργασιών για να ενεργοποιήσετε ειδοποιήσεις για την εφαρμογή του παράγοντα AI:

Εγκαταστήστε πακέτα ειδοποιήσεων.
Εισαγωγή στοιχείων ειδοποίησης
- Εισαγωγή κλάσεων ειδοποιήσεων και δεικτών χειρισμού
- Εισαγωγή τύπων δραστηριότητας και αναγνωριστικών καναλιών
Καταχώρηση διαχειριστών ειδοποιήσεων
- Χρήση μεθόδων χειρισμού ειδοποιήσεων για την καταχώρηση δρομολογήσεων
- Ρύθμιση παραμέτρων δεικτών χειρισμού για συγκεκριμένους τύπους ειδοποιήσεων (για παράδειγμα: ηλεκτρονικό ταχυδρομείο, Word, Excel, PowerPoint)
Επεξεργασία ειδοποιήσεων σε κώδικα παράγοντα
- Ο παράγοντας λαμβάνει ειδοποιήσεις από εφαρμογές του Microsoft 365
- Χειρισμός εισερχόμενων ειδοποιήσεων και κατάλληλη απόκριση

Τύποι ειδοποιήσεων

Το SDK Agent 365 υποστηρίζει τους ακόλουθους τύπους ειδοποιήσεων:

Τύποι ειδοποιήσεων	Περιγραφή	Αναγνωριστικό υπο καναλιού
Email	Ο παράγοντας λαμβάνει ένα μήνυμα ηλεκτρονικού ταχυδρομείου στο οποίο αναφέρονται ή απευθύνονται	`email`
Λέξη	Ο παράγοντας αναφέρεται σε ένα σχόλιο σε ένα έγγραφο του Word	`word`
Αριστεύω	Ο παράγοντας αναφέρεται σε ένα σχόλιο σε ένα έγγραφο του Excel	`excel`
PowerPoint 2021	Ο παράγοντας αναφέρεται σε ένα σχόλιο σε ένα έγγραφο του PowerPoint	`powerpoint`
Συμβάντα κύκλου ζωής	Ειδοποιήσεις κύκλου ζωής παράγοντα (ταυτότητα χρήστη που δημιουργήθηκε, φόρτος εργασίας προσθήκης λογαριασμών, διαγραφή χρήστη)	ΔΙ

Συμβάντα κύκλου ζωής παράγοντα

Τα συμβάντα κύκλου ζωής του παράγοντα επιτρέπουν στον πράκτορά σας να ανταποκρίνεται σε συγκεκριμένα συμβάντα συστήματος που σχετίζονται με τη διαχείριση ταυτοτήτων παράγοντα χρήστη. Το SDK υποστηρίζει επί του παρόντος τρία συμβάντα κύκλου ζωής:

Τύπος εκδήλωσης	Αναγνωριστικό συμβάντος	Περιγραφή
Δημιουργήθηκε ταυτότητα χρήστη	`agenticUserIdentityCreated`	Ενεργοποιείται κατά τη δημιουργία μιας ταυτότητας παράγοντα χρήστη
Ενημερώθηκε η προσθήκη λογαριασμών φόρτου εργασίας	`agenticUserWorkloadOnboardingUpdated`	Ενεργοποιείται όταν ενημερώνεται η κατάσταση προσθήκης λογαριασμών ενός παράγοντα χρήστη
Ο χρήστης διαγράφηκε	`agenticUserDeleted`	Ενεργοποιείται όταν διαγράφεται μια ταυτότητα παράγοντα χρήστη

Αυτά τα συμβάντα επιτρέπουν στους υπαλλήλους να εκτελούν εργασίες προετοιμασίας, λειτουργίες εκκαθάρισης ή διαχείριση κατάστασης ως απάντηση στις αλλαγές του κύκλου ζωής των χρηστών.

Προσθήκη ειδοποιήσεων στον πράκτορά σας

Ακολουθήστε αυτά τα βήματα για να ενεργοποιήσετε τον χειρισμό ειδοποιήσεων στον υπάρχοντα πράκτορά σας:

Εισαγωγή στοιχείων ειδοποίησης

Προσθέστε αυτές τις εισαγωγές στο αρχείο παράγοντα:

from microsoft_agents_a365 import AgentApplication
from microsoft_agents_a365.notifications import (
    AgentNotification,
    AgentNotificationActivity,
    NotificationTypes
)
from microsoft_agents.activity import ChannelId
from microsoft_agents.hosting.core import Authorization, TurnContext

AgentApplication: Βασική κλάση για τη δημιουργία εφαρμογών Agent365, παρέχει βασικές λειτουργίες για τη δρομολόγηση δραστηριοτήτων, τη διαχείριση κατάστασης και την επεξεργασία αιτήσεων
AgentNotification: Κλάση για την καταχώρηση διαχειριστών ειδοποιήσεων με μεθόδους decorator. Παρέχει on_agent_notification(), on_email(), on_word()και άλλους διακοσμητές ευκολίας
AgentNotificationActivity: Wrapper που περιέχει δεδομένα αναλυμένων ειδοποιήσεων με πληκτρολογημένες ιδιότητες όπως email_notification και wpx_comment_notification που περιέχουν μετα-δεδομένα για συγκεκριμένες ειδοποιήσεις (αναγνωριστικά, λεπτομέρειες συνομιλίας, αναφορές εγγράφων)
NotificationTypes: Απαρίθμηση υποστηριζόμενων τύπων ειδοποιήσεων (EMAIL_NOTIFICATION, WPX_COMMENT, AGENT_LIFECYCLE)
ChannelId: Χρησιμοποιείται για τον καθορισμό των καναλιών ειδοποίησης (π.χ., ChannelId(channel="agents", sub_channel="*"))
Εξουσιοδότηση: Περιβάλλον εξουσιοδότησης για ειδοποιήσεις επεξεργασίας
TurnContext: Η τρέχουσα συνομιλία μεταβιβάζεται από το SDK Αντιπροσώπων

import { AgentApplication, TurnContext, TurnState } from '@microsoft/agents-hosting';
import { ActivityTypes } from '@microsoft/agents-activity';
import { 
  AgentNotificationActivity,
  NotificationType
} from '@microsoft/agents-a365-notifications';

AgentApplication: Βασική κλάση για τη δημιουργία εφαρμογών Agent365, παρέχει βασικές λειτουργίες για τη δρομολόγηση δραστηριοτήτων, τη διαχείριση πολιτειών και την επεξεργασία αιτήσεων. Χρήση onAgentNotification() για την καταχώρηση δεικτών χειρισμού
AgentNotificationActivity: Ανάλυση δραστηριότητας ειδοποιήσεων με δεδομένα ειδοποιήσεων ισχυρού τύπου. Ιδιότητες όπως emailNotification και wpxCommentNotification περιέχουν μετα-δεδομένα για συγκεκριμένες ειδοποιήσεις (αναγνωριστικά, λεπτομέρειες συνομιλίας, αναφορές εγγράφων)
NotificationType: Απαρίθμηση τύπων ειδοποιήσεων (Unknown, WpxComment, EmailNotification, AgentLifecycleNotification)
TurnContext: Η τρέχουσα συζήτηση γυρίσει το περιβάλλον
TurnState: Διαχείριση κατάστασης για συνομιλία

using Microsoft.Agents.Hosting;
using Microsoft.Agents.A365.Notifications;
using Microsoft.Agents.A365.Notifications.Extensions;
using Microsoft.Agents.A365.Notifications.Models;

AgentApplication: Βασική κλάση για τη δημιουργία εφαρμογών Agent365, παρέχει βασικές λειτουργίες για τη δρομολόγηση δραστηριοτήτων, τη διαχείριση πολιτειών και την επεξεργασία αιτήσεων. Χρήση OnAgentNotification() για την καταχώρηση δεικτών χειρισμού
AgentNotificationActivity: Ενσωματώνει μια δραστηριότητα με δεδομένα ειδοποιήσεων ισχυρού τύπου. Ιδιότητες όπως EmailNotification και WpxCommentNotification περιέχουν μετα-δεδομένα για συγκεκριμένες ειδοποιήσεις (αναγνωριστικά, λεπτομέρειες συνομιλίας, αναφορές εγγράφων)
NotificationTypeEnum: Απαρίθμηση υποστηριζόμενων τύπων ειδοποιήσεων (Unknown, WpxComment, EmailNotification, AgentLifecycleNotification)
ITurnContext: Διασύνδεση που αντιπροσωπεύει το τρέχον περιβάλλον στροφής συνομιλίας
ITurnState: Διασύνδεση για τη διαχείριση κατάστασης συνομιλίας

Καταχώρηση διαχειριστών ειδοποιήσεων στον πράκτορά σας

Προσθέστε χειρισμούς ειδοποιήσεων στην προετοιμασία του παράγοντα σας:

class YourAgent(AgentApplication):
    def __init__(self, app):
        # Create notification handler
        agent_notification = AgentNotification(app)
        
        # Register handler for all notifications
        @agent_notification.on_agent_notification(
            ChannelId(channel="agents", sub_channel="*")
        )
        async def handle_all_notifications(context, state, notification):
            # Route based on notification type
            if notification.notification_type == NotificationTypes.EMAIL_NOTIFICATION:
                await self.handle_email_notification(context, state, notification)
            elif notification.notification_type == NotificationTypes.WPX_COMMENT:
                await self.handle_comment_notification(context, state, notification)
            else:
                await context.send_activity('Notification type not yet implemented.')

export class YourAgent extends AgentApplication {
  constructor() {
    super();
    
    // Register notification handler
    this.onAgentNotification("*", async (context, state, notification) => {
      await this.handleAgentNotificationActivity(context, state, notification);
    });
  }
  
  async handleAgentNotificationActivity(context, state, notification) {
    // Route based on notification type
    switch (notification.notificationType) {
      case NotificationType.EmailNotification:
        await this.handleEmailNotification(context, state, notification);
        break;
      case NotificationType.WpxComment:
        await this.handleCommentNotification(context, state, notification);
        break;
      default:
        await context.sendActivity('Notification type not yet implemented.');
    }
  }
}

public class YourAgent : AgentApplication
{
    public YourAgent()
    {
        // Register notification handler
        this.OnAgentNotification(
            "*",
            HandleNotificationAsync
        );
    }
    
    private async Task HandleNotificationAsync(
        ITurnContext turnContext,
        ITurnState turnState,
        AgentNotificationActivity activity,
        CancellationToken cancellationToken)
    {
        // Route based on notification type
        switch (activity.NotificationType)
        {
            case NotificationTypeEnum.EmailNotification:
                await HandleEmailNotificationAsync(turnContext, turnState, activity, 
                    cancellationToken);
                break;
            case NotificationTypeEnum.WpxComment:
                await HandleCommentNotificationAsync(turnContext, turnState, activity, 
                    cancellationToken);
                break;
            default:
                await turnContext.SendActivityAsync("Notification type not yet implemented.", 
                    cancellationToken: cancellationToken);
                break;
        }
    }
}

Υλοποίηση συγκεκριμένων δεικτών χειρισμού ειδοποιήσεων

Προσθέστε μεθόδους χειρισμού για κάθε τύπο ειδοποίησης:

class YourAgent(AgentApplication):
    # ... __init__ from above ...
    
    async def handle_email_notification(self, context, state, notification):
        """Handle email notifications"""
        email = notification.email_notification
        
        if not email:
            await context.send_activity('No email data found')
            return
        
        # Process the email
        await context.send_activity(
            f'Received email notification. Email ID: {email.id}'
        )
        
        # Your email processing logic here
    
    async def handle_comment_notification(self, context, state, notification):
        """Handle document comment notifications"""
        comment = notification.wpx_comment_notification
        
        if not comment:
            await context.send_activity('No comment data found')
            return
        
        # Process the comment
        await context.send_activity(
            f'Received comment notification. Document ID: {comment.document_id}'
        )
        
        # Your comment processing logic here

async handleEmailNotification(context, state, notification) {
  const email = notification.emailNotification;
  
  if (!email) {
    await context.sendActivity('No email data found');
    return;
  }
  
  // Process the email
  await context.sendActivity(`Received email notification. Email ID: ${email.id}`);
  
  // Your email processing logic here
}

async handleCommentNotification(context, state, notification) {
  const comment = notification.wpxCommentNotification;
  
  if (!comment) {
    await context.sendActivity('No comment data found');
    return;
  }
  
  // Process the comment
  await context.sendActivity(`Received comment. Document ID: ${comment.documentId}`);
  
  // Your comment processing logic here
}

private async Task HandleEmailNotificationAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    var email = activity.EmailNotification;
    
    if (email == null)
    {
        await turnContext.SendActivityAsync("No email data found", 
            cancellationToken: cancellationToken);
        return;
    }
    
    // Process the email
    await turnContext.SendActivityAsync(
        $"Received email notification. Email ID: {email.Id}",
        cancellationToken: cancellationToken
    );
    
    // Your email processing logic here
}

private async Task HandleCommentNotificationAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    var comment = activity.WpxCommentNotification;
    
    if (comment == null)
    {
        await turnContext.SendActivityAsync("No comment data found", 
            cancellationToken: cancellationToken);
        return;
    }
    
    // Process the comment
    await turnContext.SendActivityAsync(
        $"Received comment. Document ID: {comment.DocumentId}",
        cancellationToken: cancellationToken
    );
    
    // Your comment processing logic here
}

Εξειδικευμένοι χειρισμούς ειδοποιήσεων

Μετά τη ρύθμιση της βασικής δρομολόγησης ειδοποιήσεων, χρησιμοποιήστε εξειδικευμένες μεθόδους χειρισμού για πιο λεπτομερή έλεγχο. Αυτές οι μέθοδοι σάς επιτρέπουν να κάνετε τα εξής:

Καταχώρηση πολλών δεικτών χειρισμού για τον ίδιο τύπο ειδοποίησης
Ορισμός προτεραιότητας χειρισμού με κατάταξη
Ρύθμιση παραμέτρων αυτόματου ελέγχου ταυτότητας ανά πρόγραμμα χειρισμού

Σημείωμα

Για τις περισσότερες περιπτώσεις χρήσης, αρκεί το γενικό μοτίβο χειρισμού. Χρησιμοποιήστε αυτούς τους εξειδικευμένους χειρισμούς όταν χρειάζεστε σύνθετη δρομολόγηση ή πολλούς χειρισμούς για τον ίδιο τύπο ειδοποίησης.

Εξειδικευμένος χειρισμός για όλες τις ειδοποιήσεις

Καταχωρήστε περισσότερους χειρισμούς που επεξεργάζονται όλους τους τύπους ειδοποιήσεων:

from microsoft_agents_a365.notifications import (
    AgentNotification,
    NotificationTypes
)
from microsoft_agents.activity import ChannelId

# Create notification handler
agent_notification = AgentNotification(app)

# Register handler for all notifications
@agent_notification.on_agent_notification(
    ChannelId(channel="agents", sub_channel="*")
)
async def handle_all_notifications(context, state, notification):
    if notification.notification_type == NotificationTypes.EMAIL_NOTIFICATION:
        if notification.email_notification:
            await context.send_activity(f"Received email: {notification.email_notification.id}")
    elif notification.notification_type == NotificationTypes.WPX_COMMENT:
        if notification.wpx_comment_notification:
            await context.send_activity(f"Received comment: {notification.wpx_comment_notification.comment_id}")

import '@microsoft/agents-a365-notifications';

// Register handler for all notifications
app.onAgentNotification('*', async (context, state, notification) => {
  const { notificationType, emailNotification, wpxCommentNotification } = notification;

  switch (notificationType) {
    case NotificationType.EmailNotification:
      if (emailNotification) {
        console.log('Email ID:', emailNotification.id);
        await context.sendActivity('Processing your email...');
      }
      break;
    
    case NotificationType.WpxComment:
      if (wpxCommentNotification) {
        console.log('Comment ID:', wpxCommentNotification.commentId);
        await context.sendActivity('Responding to your comment...');
      }
      break;
  }
});

using Microsoft.Agents.A365.Notifications;
using Microsoft.Agents.A365.Notifications.Extensions;
using Microsoft.Agents.A365.Notifications.Models;

// Register handler for all notifications (wildcard)
this.OnAgentNotification(
    "*",
    AgentNotificationActivityAsync
);

private async Task AgentNotificationActivityAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    switch (activity.NotificationType)
    {
        case NotificationTypeEnum.EmailNotification:
            var email = activity.EmailNotification;
            if (email != null)
            {
                await turnContext.SendActivityAsync(
                    $"Received email: {email.Id}",
                    cancellationToken: cancellationToken
                );
            }
            break;
            
        case NotificationTypeEnum.WpxComment:
            var comment = activity.WpxCommentNotification;
            if (comment != null)
            {
                await turnContext.SendActivityAsync(
                    $"Received comment: {comment.CommentId}",
                    cancellationToken: cancellationToken
                );
            }
            break;
    }
}

Εξειδικευμένος χειρισμός για ειδοποιήσεις ηλεκτρονικού ταχυδρομείου

Καταχωρήστε περισσότερους χειρισμούς ειδικά για ειδοποιήσεις ηλεκτρονικού ταχυδρομείου:

from microsoft_agents_a365.notifications import AgentNotification
from microsoft_agents.activity import ChannelId, AgentSubChannel

# Create notification handler
agent_notification = AgentNotification(app)

# Use the convenience method for email notifications
@agent_notification.on_email()
async def handle_email(context, state, notification):
    email = notification.email_notification
    
    if not email:
        await context.send_activity('No email found')
        return
    
    # Process the email
    email_id = email.id
    conversation_id = email.conversation_id
    
    # Send response
    await context.send_activity('Thank you for your email!')

app.onAgenticEmailNotification(async (context, state, notification) => {
  const email = notification.emailNotification;

  if (!email) {
    await context.sendActivity('No email found');
    return;
  }

  // Process the email
  console.log('Email ID:', email.id);
  console.log('Conversation ID:', email.conversationId);

  // Send a response
  await context.sendActivity('Thank you for your email!');
});

// Register handler for email notifications
this.OnAgenticEmailNotification(HandleEmailNotificationAsync);

private async Task HandleEmailNotificationAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    var email = activity.EmailNotification;
    
    if (email == null)
    {
        await turnContext.SendActivityAsync("No email found", 
            cancellationToken: cancellationToken);
        return;
    }
    
    // Process email
    var emailId = email.Id;
    var conversationId = email.ConversationId;
    
    // Send response
    await turnContext.SendActivityAsync(
        "Thank you for your email!",
        cancellationToken: cancellationToken
    );
}

Εξειδικευμένοι χειριστές για σχόλια εγγράφων

Καταχωρήστε περισσότερους χειρισμούς για ειδοποιήσεις σχολίων στα Word, Excel και PowerPoint:

from microsoft_agents_a365.notifications import AgentNotification

# Create notification handler
agent_notification = AgentNotification(app)

# Use convenience methods for document notifications
@agent_notification.on_word()
async def handle_word(context, state, notification):
    comment = notification.wpx_comment_notification
    
    if comment:
        document_id = comment.document_id
        comment_id = comment.comment_id
        await context.send_activity(f'Processing Word comment: {comment_id}')

@agent_notification.on_excel()
async def handle_excel(context, state, notification):
    comment = notification.wpx_comment_notification
    
    if comment:
        await context.send_activity('Processing Excel comment')

@agent_notification.on_powerpoint()
async def handle_powerpoint(context, state, notification):
    comment = notification.wpx_comment_notification
    
    if comment:
        await context.send_activity('Processing PowerPoint comment')

// Handle Word notifications
app.onAgenticWordNotification(async (context, state, notification) => {
  const comment = notification.wpxCommentNotification;
  
  if (comment) {
    console.log('Word comment:', comment.commentText);
    await context.sendActivity('Processing your Word comment...');
  }
});

// Handle Excel notifications
app.onAgenticExcelNotification(async (context, state, notification) => {
  const comment = notification.wpxCommentNotification;
  
  if (comment) {
    await context.sendActivity('Processing your Excel comment...');
  }
});

// Handle PowerPoint notifications
app.onAgenticPowerPointNotification(async (context, state, notification) => {
  const comment = notification.wpxCommentNotification;
  
  if (comment) {
    await context.sendActivity('Processing your PowerPoint comment...');
  }
});

// Register handlers for document notifications
this.OnAgenticWordNotification(HandleWordNotificationAsync);
this.OnAgenticExcelNotification(HandleExcelNotificationAsync);
this.OnAgenticPowerPointNotification(HandlePowerPointNotificationAsync);

private async Task HandleWordNotificationAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    var comment = activity.WpxCommentNotification;
    
    if (comment != null)
    {
        await turnContext.SendActivityAsync(
            $"Processing Word comment: {comment.CommentText}",
            cancellationToken: cancellationToken
        );
    }
}

private async Task HandleExcelNotificationAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    var comment = activity.WpxCommentNotification;
    
    if (comment != null)
    {
        await turnContext.SendActivityAsync(
            "Processing Excel comment",
            cancellationToken: cancellationToken
        );
    }
}

private async Task HandlePowerPointNotificationAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    var comment = activity.WpxCommentNotification;
    
    if (comment != null)
    {
        await turnContext.SendActivityAsync(
            "Processing PowerPoint comment",
            cancellationToken: cancellationToken
        );
    }
}

Εξειδικευμένοι χειριστές για συμβάντα κύκλου ζωής

Καταχωρήστε περισσότερους χειρισμούς για συμβάντα κύκλου ζωής αντιπροσώπων, όπως δημιουργία ταυτότητας χρήστη, προσθήκη φόρτου εργασίας και διαγραφή χρήστη:

from microsoft_agents_a365.notifications import AgentNotification

# Create notification handler
agent_notification = AgentNotification(app)

# Handle all lifecycle events
@agent_notification.on_agent_lifecycle_notification("*")
async def handle_lifecycle(context, state, notification):
    lifecycle_notification = notification.agent_lifecycle_notification
    if lifecycle_notification:
        event_type = lifecycle_notification.lifecycle_event_type
        
        if event_type == "agenticUserIdentityCreated":
            await context.send_activity('User identity created')
        elif event_type == "agenticUserWorkloadOnboardingUpdated":
            await context.send_activity('Workload onboarding completed')
        elif event_type == "agenticUserDeleted":
            await context.send_activity('User identity deleted')

// Handle all lifecycle notifications
app.onLifecycleNotification(async (context, state, notification) => {
  await context.sendActivity('Lifecycle event received');
});

// Handle specific lifecycle events
app.onAgenticUserCreatedNotification(async (context, state, notification) => {
  await context.sendActivity('User identity created');
});

app.onAgenticUserWorkloadOnboardingNotification(
  async (context, state, notification) => {
    await context.sendActivity('Workload onboarding completed');
  }
);

app.onAgenticUserIdentityDeletedNotification(
  async (context, state, notification) => {
    await context.sendActivity('User identity deleted');
  }
);

// Register lifecycle notification handlers
this.OnLifecycleNotification(HandleAllLifecycleEventsAsync);
this.OnAgenticUserIdentityCreatedNotification(HandleUserCreatedAsync);
this.OnAgenticUserWorkloadOnboardingNotification(HandleWorkloadOnboardingAsync);
this.OnAgenticUserDeletedNotification(HandleUserDeletedAsync);

private async Task HandleAllLifecycleEventsAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    await turnContext.SendActivityAsync(
        "Lifecycle event received",
        cancellationToken: cancellationToken
    );
}

private async Task HandleUserCreatedAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    await turnContext.SendActivityAsync(
        "User identity created",
        cancellationToken: cancellationToken
    );
}

private async Task HandleWorkloadOnboardingAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    await turnContext.SendActivityAsync(
        "Workload onboarding completed",
        cancellationToken: cancellationToken
    );
}

private async Task HandleUserDeletedAsync(
    ITurnContext turnContext,
    ITurnState turnState,
    AgentNotificationActivity activity,
    CancellationToken cancellationToken)
{
    await turnContext.SendActivityAsync(
        "User identity deleted",
        cancellationToken: cancellationToken
    );
}

Ρύθμιση παραμέτρων για προχωρημένους

Αυτή η ενότητα καλύπτει τις επιλογές ρύθμισης παραμέτρων για προχωρημένους για τη ρύθμιση των λεπτομερούς ρύθμισης των χειρών ειδοποιήσεων. Αυτές οι ρυθμίσεις παραμέτρων σάς επιτρέπουν να ελέγχετε τη σειρά εκτέλεσης του χειρισμού, να διαχειρίζεστε απαιτήσεις ελέγχου ταυτότητας και να βελτιστοποιείτε την επεξεργασία ειδοποιήσεων για σύνθετα σενάρια.

Προτεραιότητα χειρισμού και κατάταξη

Όταν χρησιμοποιείτε πολλούς εξειδικευμένους χειρισμούς, μπορείτε να καθορίσετε τη σειρά προτεραιότητας χρησιμοποιώντας τιμές κατάταξης. Οι χαμηλότερες τιμές κατάταξης υποδεικνύουν υψηλότερη προτεραιότητα:

from microsoft_agents_a365.notifications import AgentNotification
from microsoft_agents.activity import ChannelId, AgentSubChannel

# Create notification handler
agent_notification = AgentNotification(app)

# Higher priority handler (processed first)
@agent_notification.on_email(rank=100)
async def high_priority_email(context, state, notification):
    # Handle with high priority
    pass

# Lower priority handler (processed after higher priority)
@agent_notification.on_email(rank=200)
async def low_priority_email(context, state, notification):
    # Handle with lower priority
    pass

// Higher priority handler (lower rank number)
app.onAgenticEmailNotification(
  async (context, state, notification) => {
    // Handle email with high priority
  },
  100 // rank
);

// Lower priority handler
app.onAgenticEmailNotification(
  async (context, state, notification) => {
    // Handle email with lower priority
  },
  200 // rank
);

// Higher priority handler (lower rank number)
this.OnAgenticEmailNotification(
    HighPriorityEmailHandlerAsync,
    rank: 100
);

// Lower priority handler
this.OnAgenticEmailNotification(
    LowerPriorityEmailHandlerAsync,
    rank: 200
);

Χειρισμός ελέγχου ταυτότητας

Ρυθμίστε τις παραμέτρους των δεικτών χειρισμού αυτόματης εισόδου για ειδοποιήσεις που απαιτούν έλεγχο ταυτότητας:

from microsoft_agents_a365.notifications import AgentNotification
from microsoft_agents.activity import ChannelId, AgentSubChannel

# Create notification handler
agent_notification = AgentNotification(app)

# Handler with automatic authentication
@agent_notification.on_email(auto_sign_in_handlers=['agentic'])
async def authenticated_email(context, state, notification):
    # Authentication is handled automatically
    pass

app.onAgenticEmailNotification(
  async (context, state, notification) => {
    // Handler with automatic authentication
  },
  32767, // rank (default)
  ['agentic'] // autoSignInHandlers
);

this.OnAgenticEmailNotification(
    HandleAuthenticatedEmailAsync,
    rank: 32767,
    autoSignInHandlers: new[] { "agentic" }
);

Δοκιμή και παρακολούθηση

Δοκιμάστε τον πράκτορά σας με ειδοποιήσεις

Μετά την υλοποίηση των διαχειριστών ειδοποιήσεων, δοκιμάστε τον πράκτορά σας για να διασφαλίσετε ότι λαμβάνει σωστά και επεξεργάζεται διαφορετικούς τύπους ειδοποιήσεων. Ακολουθήστε τον οδηγό δοκιμών για να ρυθμίσετε το περιβάλλον σας και, στη συνέχεια, εστιάστε κυρίως στην ενότητα Δοκιμή με δραστηριότητες ειδοποιήσεων για να επικυρώσετε τις ειδοποιήσεις σας χρησιμοποιώντας έλεγχο ταυτότητας παράγοντα.

Παρακολούθηση χειρισμού ειδοποιήσεων

Παρακολουθήστε τον χειρισμό ειδοποιήσεων του παράγοντα σας, προσθέτοντας δυνατότητες παρατηρήσεων. Παρακολουθήστε την επεξεργασία ειδοποιήσεων, τους χρόνους απόκρισης και τους ρυθμούς σφαλμάτων για να κατανοήσετε την απόδοση του παράγοντα. Μάθετε περισσότερα σχετικά με την υλοποίηση ανίχνευσης και παρακολούθησης

Ανάδραση

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2025-11-18