MeshWeaver.AI.AzureOpenAI 2.3.0

MeshWeaver.AI.AzureOpenAI

Overview

MeshWeaver.AI.AzureOpenAI provides Azure OpenAI integration for the MeshWeaver AI framework, enabling AI-powered agent chats using Azure OpenAI's ChatCompletionAgent. This library is designed for stateless chat completion scenarios without persistent assistant storage.

Features

• Azure OpenAI Integration: Direct integration with Azure OpenAI services
• ChatCompletionAgent Support: Uses Microsoft Semantic Kernel's ChatCompletionAgent for stateless operations
• Factory Pattern: Implements the factory pattern for creating and managing agent chats
• Configuration-Based Setup: Uses AIConfiguration for secure credential management
• Extensible Architecture: Built on top of MeshWeaver.AI's ChatCompletionAgentChatFactory base class

Installation

This package is part of the MeshWeaver solution and should be referenced as a project dependency:

<ProjectReference Include="..\MeshWeaver.AI.AzureOpenAI\MeshWeaver.AI.AzureOpenAI.csproj" />

Configuration

1. Configure AI Credentials

Add the following configuration to your appsettings.json:

{
  "AI": {
    "Url": "https://your-azure-openai-endpoint.openai.azure.com/",
    "ApiKey": "your-api-key-here",
    "Models": ["gpt-4", "gpt-35-turbo"]
  }
}

2. Register Services

In your Program.cs or service configuration:

using MeshWeaver.AI.AzureOpenAI;

// Configure AI credentials
builder.Services.Configure<AIConfiguration>(
    builder.Configuration.GetSection("AI"));

// Add Azure OpenAI services
builder.Services.AddAzureOpenAI();

Usage

Basic Implementation

public class MyService
{
    private readonly IAgentChatFactory _chatFactory;

    public MyService(IAgentChatFactory chatFactory)
    {
        _chatFactory = chatFactory;
    }

    public async Task<IAgentChat> CreateChatAsync()
    {
        var agentChat = await _chatFactory.CreateAsync();
        return agentChat;
    }
}

Agent Definition

Create custom agents by implementing IAgentDefinition:

public class MyCustomAgent : IAgentDefinition
{
    public string Name => "MyAgent";
    public string Description => "A custom AI agent for specific tasks";
    public string Instructions => "You are a helpful assistant specialized in...";
}

Architecture

Class Hierarchy

ChatCompletionAgentChatFactory (MeshWeaver.AI)
└── AzureOpenAIChatCompletionAgentChatFactory (MeshWeaver.AI.AzureOpenAI)

Key Components

• AzureOpenAIChatCompletionAgentChatFactory: Main factory class for creating Azure OpenAI-powered agent chats
• AzureOpenAIExtensions: Extension methods for service registration
• AIConfiguration: Configuration model for Azure OpenAI credentials

Security Considerations

• API Key Management: Store API keys securely using Azure Key Vault or similar secure storage
• Environment Variables: Consider using environment variables for sensitive configuration
• Network Security: Ensure secure communication with Azure OpenAI endpoints

Dependencies

• Microsoft.SemanticKernel
• Microsoft.Extensions.Options
• Microsoft.Extensions.DependencyInjection.Abstractions
• MeshWeaver.AI
• MeshWeaver.Messaging.Hub

Troubleshooting

Common Issues

1. Missing API Key: Ensure AIConfiguration.ApiKey is properly configured
2. Invalid Endpoint: Verify the AIConfiguration.Url format
3. Model Not Available: Check that the specified models exist in your Azure OpenAI deployment

Logging

Enable detailed logging to troubleshoot issues:

builder.Services.AddLogging(logging =>
{
    logging.AddConsole();
    logging.SetMinimumLevel(LogLevel.Debug);
});

Related Projects

• MeshWeaver.AI - Core AI services and abstractions
• MeshWeaver.AI.AzureFoundry - Azure AI Foundry integration
• MeshWeaver.Portal.AI - Portal-specific AI implementations
• MeshWeaver.Blazor.Chat - Chat UI components

Contributing

This project is part of the MeshWeaver ecosystem. Please follow the established patterns and conventions when contributing.