Dev v4 #702

Roopan-Microsoft · 2025-12-10T18:15:14Z

Purpose

...

Does this introduce a breaking change?

Yes
No

How to Test

Get the code

git clone [repo-address]
cd [repo-name]
git checkout [branch-name]
npm install

Test the code

What to Check

Verify that the following are valid

...

Other Information

Replaced semantic-kernel imports and dependencies with agent-framework in config, models, and utils. Updated pyproject.toml to add agent-framework and remove semantic-kernel. This refactor aligns the codebase with the new agent-framework library for agent and kernel functionality.

Migrate from semantic-kernel to agent-framework

Adds a comprehensive AVM post-deployment guide and refactors post-deployment scripts (PowerShell and Bash) to support both azd and ARM/Bicep deployments, including improved Azure subscription selection and output parsing. Updates FastAPI app to use a lifespan context for agent cleanup on shutdown. Refactors CosmosDB and config code for clarity and style. Updates workflow files for more flexible test and deployment handling. Introduces new frontend components and hooks for plan cancellation dialog and alert, and updates related styles and service logic.

Added agent-framework-core, agent-framework-azure-ai, agent-framework-copilotstudio, agent-framework-devui, agent-framework-mem0, and agent-framework-redis as dependencies from the Microsoft agent-framework repository. Updated azure-ai-agents to version 1.2.0b5 and upgraded aiohttp to 3.13.1.

Macae rfp af 101725

Replaced references to agent_framework with semantic_kernel in app_config.py and utils_kernel.py. Updated models in messages_kernel.py to use KernelBaseModel and Field from semantic_kernel.kernel_pydantic for consistency with the new package structure.

Macae rfp af 101725

Deleted the websocket_streaming.py module and removed the create_kernel method from AppConfig, as the system now uses Azure AI Agent Project pattern. Added placeholder files for messages_af.py and utils_af.py to support future Azure Foundry integration.

Introduces new Pydantic-based data models in messages_af.py to replace KernelBaseModel from semantic_kernel. All original model names and structures are preserved to support incremental migration from the previous framework.

Deleted src/backend/common/utils/check_deployments.py as it is no longer needed. This script was used to check Azure AI Foundry model deployments and their statuses.

Introduces the main FastAPI router for agent framework v3, including endpoints for team management, plan creation, approval, agent messaging, and configuration upload. Adds callback handlers for agent responses and streaming, global debug access, and service skeletons for agents, base API, foundry, MCP, and team management. These files establish the backend structure for multi-agent orchestration and extensible service integration.

Introduces common lifecycle management for agents, new agent configuration models, and refactors ProxyAgent and ReasoningAgentTemplate to use agent_framework primitives. Removes Semantic Kernel dependencies, adds Azure AI Search integration, and streamlines agent creation and invocation logic for improved maintainability and extensibility.

Updated import paths from 'v3' to 'af' for consistency and modularity. Improved error handling, logging, and tool/resource collection logic in FoundryAgentTemplate. Cleaned up unused Bing references and clarified code interpreter and MCP tool handling. These changes enhance maintainability and agent lifecycle management.

Changed imports from 'agent_framework.azure' to 'agent_framework_azure_ai' for AzureAIAgentClient in foundry_agent.py and reasoning_agent.py. Also removed an unused import in lifecycle.py to clean up dependencies.

Migrates orchestration logic and related services from semantic-kernel (v3) to agent_framework, updating imports, manager classes, and workflow construction. Updates HumanApprovalMagenticManager and OrchestrationManager to use agent_framework APIs, adapts callback handling, and ensures compatibility with new message and agent structures. Cleans up legacy code and improves maintainability for future agent_framework-based enhancements.

fix: Macae rfp af 101725

Deleted the entire v3 API router, callbacks, and common service modules including agent, base API, foundry, and MCP services, as well as related configuration, models, and orchestration files. This change removes the v3 backend implementation, likely in preparation for a major refactor or migration.

Renamed src/backend/app_kernel.py to src/backend/app.py. Updated import paths to reference 'af' modules instead of 'v3' and 'messages_af' instead of 'messages_kernel' to reflect new module structure.

Updated Dockerfiles, app.py, and tests to reference 'app' instead of 'app_kernel'. This change standardizes the application entry point and module imports, improving consistency across the backend codebase.

Macae rfp af 101725

Replaced references to deprecated Semantic Kernel and v3 modules with agent_framework (af) equivalents throughout backend, database, and test files. Removed obsolete messages_kernel and utils_kernel files, updated import paths, and fixed minor typos. Updated documentation and README to reflect new entry points and usage.

Replaced Semantic Kernel dependencies and terminology with agent_framework equivalents across backend modules, including response handlers, configuration, agent factories, orchestration, and utility functions. Updated imports, class names, comments, and logic to reflect agent_framework usage. Adjusted test files and MCP authentication to use agent_framework constructs. This refactor enables the system to operate with agent_framework as the core agent orchestration and messaging library.

Macae rfp af 101725

Deleted src/mcp_server/auth.py, which contained MCP authentication and HostedMCPTool setup logic for the employee onboarding system. This change may indicate a refactor, deprecation, or migration of authentication and plugin management functionality.

Reformatted code in human_approval_manager.py and orchestration_manager.py for better readability, including consistent indentation, line breaks, and argument formatting. No functional changes were made; this refactor aims to enhance maintainability and clarity.

Macae rfp af 101725

Added use cases for Product Marketing, Onboarding Employee, and Retail Remediation, highlighting challenges and approaches.

Updated the Retail Remediation section to reflect changes in the approach for managing workflows and customer satisfaction.

docs: Add use case section to README

…e-change-rfp docs: update images - remove sk reference

…tration_manager

…manager

fix: added new case in bash and change the index name

style: formatting fixes and import cleanup for pylint compliance

Added additional instructions to the RAI agent creation prompt to cover nested, hypothetical, code-based, and information gathering jailbreaking attempts. This enhances the agent's ability to identify and block a wider range of potential jailbreak scenarios.

Expand jailbreaking detection guidelines in RAI agent

…-contract docs: update icons in readme architecture

Updated RAI agent instructions

…p-contract docs: Doc image and agent name v4 rfp contract

chore: resolved conflitcs

fix: added pylint changes and yaml file changes

feat: Macae rfp agent framework

src/frontend/src/components/content/HomeInput.tsx

+const HomeInput: React.FC<HomeInputProps> = ({ selectedTeam }) => {
+  const [submitting, setSubmitting] = useState<boolean>(false);
+  const [input, setInput] = useState<string>("");
+  const [raiError, setRAIError] = useState<RAIErrorData | null>(null);


src/frontend/src/services/TeamService.tsx

    static async deleteTeam(teamId: string): Promise<boolean> {
        try {
-            const response = await apiClient.delete(`/v3/team_configs/${teamId}`);
+            const response = await apiClient.delete(`/v4/team_configs/${teamId}`);


src/backend/v4/magentic_agents/models/agent_models.py

+    def from_env(cls, index_name: str) -> "SearchConfig":
        connection_name = config.AZURE_AI_SEARCH_CONNECTION_NAME
-        index_name = config.AZURE_AI_SEARCH_INDEX_NAME
+        index_name = index_name
