microsoft-agents-ai-migration

Migrate Microsoft.Agents.AI packages between preview versions with automated dotnet scripts.

57|7|Updated Aug 6, 2025
One-click install
npx skills add https://github.com/seiggy/lucia-dotnet --skill microsoft-agents-ai-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: microsoft-agents-ai-migration
Source: https://github.com/seiggy/lucia-dotnet/tree/main/.github/skills/microsoft-agents-ai-migration
Command: npx skills add https://github.com/seiggy/lucia-dotnet --skill microsoft-agents-ai-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide and automated tools to help developers migrate their existing Microsoft.Agents.AI implementations between specific package versions, minimizing disruption and ensuring compatibility.

Core Features & Use Cases

  • Automated Migration Script: Executes a dotnet script to automatically apply common renames and namespace changes.
  • Detailed Breaking Changes: Clearly outlines all API renames, namespace consolidations, and behavioral changes.
  • Use Case: A developer needs to update their AI agent project from 1.0.0-preview.251204.1 to 1.0.0-preview.260212.1. This Skill provides the exact steps, scripts, and documentation to perform the upgrade smoothly.

Quick Start

Run the dotnet script scripts/migrate.csx to automate the migration process.

Frequently Asked Questions about microsoft-agents-ai-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate my .NET AI agent project to the latest Microsoft.Agents.AI preview version?

You can migrate your .NET AI agent project by running the provided `dotnet script` to automatically apply API renames, namespace changes, and async pattern updates. This script handles the transition from version 1.0.0-preview.251204.1 to 1.0.0-preview.260212.1.

What are the breaking changes when updating Microsoft.Agents.AI packages?

The breaking changes include API renames, namespace consolidations, and behavioral modifications. The Skill provides detailed documentation outlining these specific changes, dependency updates, and new features to ensure your framework upgrade is smooth.

Does the Microsoft.Agents.AI migration script handle async pattern updates automatically?

Yes, the automated migration script handles async pattern updates automatically. It executes common renames and namespace changes to streamline the framework upgrade process without requiring manual code edits.

Can I use this migration tool for .NET framework upgrades beyond Microsoft.Agents.AI?

No, this tool specifically facilitates migrating Microsoft.Agents.AI package versions. It addresses API renames, namespace changes, async pattern updates, and .NET framework upgrades strictly within the scope of this specific AI agent framework.

Why does my AI agent project break after updating to Microsoft.Agents.AI 1.0.0-preview.260212.1?

Your project breaks due to breaking changes in the new preview version, including API renames and namespace consolidations. Running the provided migration script applies the necessary fixes to resolve these compatibility issues.