Aracılara bildirme

Önemli

Microsoft Agent 365'e erken erişim elde etmek için Frontier önizleme programının bir parçası olmanız gerekir. Frontier sizi Doğrudan Microsoft'un en son yapay zeka yenilikleri ile bağlar. Sınır önizlemeleri, müşteri sözleşmelerinizin mevcut önizleme koşullarına tabidir. Bu özellikler hala geliştirme aşamasında olduğundan, bunların kullanılabilirliği ve özellikleri zaman içinde değişebilir.

Bildirimler modülü, geliştiricilerin Microsoft 365 uygulamalarından gelen olaylara ve bildirimlere yanıt verebilen aracılar oluşturmasına olanak tanır. Bildirimler desteğiyle, kullanıcılar e-posta, belge açıklamaları veya diğer işbirliğine dayalı senaryolar aracılığıyla onlarla etkileşime geçtiğinde aracılar uyarı alabilir ve bunları işleyebilir.

Bildirimler iş akışı

Yapay zeka aracısı uygulamanız için bildirimleri etkinleştirmek için bu iş akışını izleyin:

1. Bildirim paketlerini yükleyin.

2. Bildirim bileşenlerini içeri aktarma

   • Bildirim sınıflarını ve işleyicilerini içeri aktarma
   • Etkinlik türlerini ve kanal tanımlayıcılarını içeri aktarma

3. Bildirim işleyicilerini kaydetme

   • Yolları kaydetmek için bildirim işleyicisi yöntemlerini kullanma
   • Belirli bildirim türleri için işleyicileri yapılandırma (Örneğin: e-posta, Word, Excel, PowerPoint)

4. Aracı kodunda bildirimleri işleme

   • Aracı, Microsoft 365 uygulamalarından bildirim alır
   • Gelen bildirimleri işleme ve uygun şekilde yanıtlama

Bildirim türleri

, aşağıdaki bildirim türlerini destekler.

Bildirim Türü	Description	Alt Kanal Kimliği
E-posta	Aracı, bahsedildiği veya adreslendiği bir e-posta alır	email
Kelime	Aracı, Word belgesindeki bir yorumda belirtilir	word
Excel	Aracı, Excel belgesindeki bir açıklamada belirtilir	excel
PowerPoint 2021	Aracı, PowerPoint belgesindeki bir açıklamada belirtilir	powerpoint
Yaşam Döngüsü Olayları	Aracı yaşam döngüsü bildirimleri (kullanıcı kimliği oluşturuldu, iş yükü ekleme, kullanıcı silindi)	Geçersiz

Aracı yaşam döngüsü olayları

Aracı yaşam döngüsü olayları, aracınızın aracılı kullanıcı kimliği yönetimiyle ilgili belirli sistem olaylarına yanıt vermesini sağlar. SDK şu anda üç yaşam döngüsü olayını destekler:

Etkinlik Türü	Olay Kimliği	Description
Kullanıcı Kimliği Oluşturuldu	agenticUserIdentityCreated	Aracı kullanıcı kimliği oluşturulduğunda tetikleniyor
İş Yükü Ekleme Güncelleştirildi	agenticUserWorkloadOnboardingUpdated	Aracı kullanıcının iş yükü ekleme durumu güncelleştirildiğinde tetiklendi
Kullanıcı Silindi	agenticUserDeleted	Aracı kullanıcı kimliği silindiğinde tetikleniyor

Bu olaylar, aracıların kullanıcı yaşam döngüsü değişikliklerine yanıt olarak başlatma görevleri, temizleme işlemleri veya durum yönetimi gerçekleştirmesine olanak tanır.

Temsilcinize Bildirim Ekleme

Mevcut aracınızda bildirim işlemeyi etkinleştirmek için şu adımları izleyin:

Bildirim bileşenlerini içeri aktarma

Aracı dosyanıza şu içeri aktarmaları ekleyin:

Piton

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 uygulamaları oluşturmaya yönelik temel sınıf; yönlendirme etkinlikleri, yönetim durumu ve istekleri işleme için temel işlevsellik sağlar
• AgentNotification: Bildirim işleyicilerini dekoratör yöntemleriyle kaydetme sınıfı. on_agent_notification(), on_email(), on_word()ve diğer kolaylık dekoratörleri sağlar
• AgentNotificationActivity: Bildirime özgü meta verileri (kimlikler, konuşma ayrıntıları, belge başvuruları) içeren ve wpx_comment_notification gibi email_notification yazılan özelliklere sahip ayrıştırılmış bildirim verilerini içeren sarmalayıcı
• NotificationTypes: Desteklenen bildirim türlerinin sabit listesi (EMAIL_NOTIFICATION, WPX_COMMENT, AGENT_LIFECYCLE)
• ChannelId: Bildirim kanallarını belirtmek için kullanılır (ör. ChannelId(channel="agents", sub_channel="*"))
• Yetkilendirme: Bildirimleri işlemek için yetkilendirme bağlamı
• TurnContext: Geçerli konuşma Aracılar SDK'sından bağlamı döndür

JavaScript

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

• AgentApplication: Agent365 uygulamaları oluşturmaya yönelik temel sınıf; yönlendirme etkinlikleri, yönetim durumu ve istekleri işleme için temel işlevsellik sağlar. İşleyicileri kaydetmek için kullanın onAgentNotification()
• AgentNotificationActivity: Kesin olarak yazılan bildirim verileriyle ayrıştırılmış bildirim etkinliği. ve gibi emailNotification özellikler wpxCommentNotification bildirime özgü meta veriler (kimlikler, konuşma ayrıntıları, belge başvuruları) içerir
• NotificationType: Bildirim türlerinin sabit listesi (Unknown, WpxComment, EmailNotification, AgentLifecycleNotification)
• TurnContext: Geçerli konuşma bağlamı döndür
• TurnState: Konuşma için durum yönetimi

.NET

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

• AgentApplication: Agent365 uygulamaları oluşturmaya yönelik temel sınıf; yönlendirme etkinlikleri, yönetim durumu ve istekleri işleme için temel işlevsellik sağlar. İşleyicileri kaydetmek için kullanın OnAgentNotification()
• AgentNotificationActivity: Etkinliği kesin olarak yazılan bildirim verileriyle sarmalar. ve gibi EmailNotification özellikler WpxCommentNotification bildirime özgü meta veriler (kimlikler, konuşma ayrıntıları, belge başvuruları) içerir
• NotificationTypeEnum: Desteklenen bildirim türlerinin (Unknown, WpxComment, , EmailNotificationAgentLifecycleNotification) numaralandırması
• ITurnContext: Geçerli konuşma dönüş bağlamını temsil eden arabirim
• ITurnState: Konuşma durumu yönetimi arabirimi

Aracınıza bildirim işleyicilerini kaydetme

Aracınızın başlatılmasına bildirim işleyicileri ekleyin:

Piton

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.')

JavaScript

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.');
    }
  }
}

.NET

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;
        }
    }
}

Belirli bildirim işleyicilerini uygulama

Her bildirim türü için işleyici yöntemleri ekleyin:

Piton

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

JavaScript

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
}

.NET

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
}

Özel Bildirim İşleyicileri

Temel bildirim yönlendirmesini ayarladıktan sonra daha ayrıntılı denetim için özel işleyici yöntemlerini kullanın. Bu yöntemler şunları yapmanızı sağlar:

• Aynı bildirim türü için birden çok işleyici kaydetme
• İşleyici önceliğini derecelendirme ile ayarlama
• İşleyici başına otomatik kimlik doğrulamayı yapılandırma

Not

Çoğu kullanım örneği için genel işleyici deseni yeterlidir. Aynı bildirim türü için gelişmiş yönlendirmeye veya birden çok işleyiciye ihtiyacınız olduğunda bu özel işleyicileri kullanın.

Tüm bildirimler için özel işleyici

Tüm bildirim türlerini işleyen daha fazla işleyici kaydedin:

Piton

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

JavaScript

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;
  }
});

.NET

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;
    }
}

E-posta bildirimleri için özel işleyici

Özellikle e-posta bildirimleri için daha fazla işleyici kaydedin:

Piton

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!')

JavaScript

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!');
});

.NET

// 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
    );
}

Belge açıklamaları için özel işleyiciler

Word, Excel ve PowerPoint açıklama bildirimleri için daha fazla işleyici kaydedin:

Piton

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')

JavaScript

// 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...');
  }
});

.NET

// 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
        );
    }
}

Yaşam döngüsü olayları için özel işleyiciler

Kullanıcı kimliği oluşturma, iş yükü ekleme ve kullanıcı silme gibi aracı yaşam döngüsü olayları için daha fazla işleyici kaydedin:

Piton

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')

JavaScript

// 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');
  }
);

.NET

// 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
    );
}

Gelişmiş yapılandırma

Bu bölüm, bildirim işleyicilerinizde ince ayarlamalar yapmak için gelişmiş yapılandırma seçeneklerini kapsar. Bu yapılandırmalar, işleyici yürütme sırasını denetlemenize, kimlik doğrulama gereksinimlerini yönetmenize ve karmaşık senaryolar için bildirim işlemeyi iyileştirmenize olanak tanır.

İşleyici önceliği ve derecelendirmesi

Birden çok özel işleyici kullanırken, sıralama değerlerini kullanarak öncelik sırasını belirtebilirsiniz. Düşük değerler daha yüksek önceliğe işaret eder.

Piton

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

JavaScript

// 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
);

.NET

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

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

Kimlik doğrulama işleyicileri

Kimlik doğrulaması gerektiren bildirimler için otomatik oturum açma işleyicilerini yapılandırın:

Piton

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

JavaScript

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

.NET

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

Test etme ve izleme

Aracınızı bildirimlerle test edin

Bildirim işleyicilerini uyguladıktan sonra aracınızı test ederek farklı bildirim türlerini doğru şekilde aldığından ve işlediğine emin olun. Ortamınızı ayarlamak için test kılavuzunu izleyin, ardından aracı kimlik doğrulamasını kullanarak bildirimlerinizi doğrulamak için öncelikle Bildirim etkinlikleriyle test etme bölümüne odaklanın.

Bildirim işlemeyi izleme

Gözlemlenebilirlik özellikleri ekleyerek aracınızın bildirim işlemesini izleyin. Aracı performansını anlamak için bildirim işlemeyi, yanıt sürelerini ve hata oranlarını izleyin. İzleme ve izleme uygulama hakkında daha fazla bilgi edinin