Skip to content

refactor: Agent framework v2 changes#803

Open
Pavan-Microsoft wants to merge 86 commits intomainfrom
dev
Open

refactor: Agent framework v2 changes#803
Pavan-Microsoft wants to merge 86 commits intomainfrom
dev

Conversation

@Pavan-Microsoft
Copy link
Contributor

Purpose

This pull request introduces several updates to documentation and deployment scripts to support the integration of the Azure AI Agent Framework (AFV2), improve post-deployment guidance, and streamline agent creation and sample data processing workflows. The most important changes include updating image tags and references for AFV2 across deployment workflows, revising documentation to clarify agent creation steps, and updating script parameters for improved clarity and flexibility.

Deployment workflow updates:

  • Changed image tag references from latest_waf to latest_afv2 in .github/workflows/deploy-KMGeneric.yml, .github/workflows/docker-build.yml, and .github/workflows/job-azure-deploy.yml to align with Azure AI Agent Framework v2. [1] [2] [3] [4]
  • Updated the parameter description for AZURE_ENV_IMAGETAG in documents/CustomizingAzdParameters.md to use latest_afv2 as the default value.

Documentation improvements for agent creation and post-deployment steps:

  • Revised documents/AVMPostDeploymentGuide.md to introduce explicit steps for creating and activating a Python virtual environment, agent creation (via run_create_agents_scripts.sh), and sample data processing, with clearer ordering and instructions. [1] [2] [3] [4] [5]
  • Updated documents/DeploymentGuide.md to add detailed instructions and parameter descriptions for running the agent creation script, and revised sample data processing script parameters to include the solution name. [1] [2] [3]
  • Modified documents/CustomizeData.md and documents/AVMPostDeploymentGuide.md to update script parameters for custom data processing, adding solution name and reordering arguments for clarity. [1] [2]

Script and configuration updates:

  • Enhanced post-provision hooks in azure.yaml and azure_custom.yaml to include instructions for running the agent creation script before sample data processing, improving user guidance for both Windows and POSIX environments. [1] [2] [3]

Solution overview and security documentation changes:

  • Updated README.md to reference Azure AI Agent Framework in the solution overview and removed Azure Key Vault from the pricing and security sections, emphasizing Managed Identity for secure access. [1] [2] [3]

Workshop requirements update:

  • Upgraded semantic-kernel[azure] dependency in docs/workshop/docs/workshop/requirements.txt from version 1.28.0 to 1.40.0.

Does this introduce a breaking change?

  • Yes
  • No

Golden Path Validation

  • I have tested the primary workflows (the "golden path") to ensure they function correctly without errors.

Deployment Validation

  • I have validated the deployment process successfully and all services are running as expected with this change.

Pavan-Microsoft and others added 30 commits December 4, 2025 11:12
…emove unused agent factory classes, streamline ChatService and HistoryService, and enhance SQLTool for better database interaction. Update API routes and configuration management for improved clarity and performance. Upgrade dependencies in requirements.txt for compatibility with new Azure SDK versions.
…gin, ChatService, HistoryService, and App

- Removed test cases for deprecated agent factories in test_app.py.
- Updated test cases in test_chat_with_data_plugin.py to reflect changes in the ChatWithDataPlugin implementation.
- Refactored test cases in test_chat_service.py to remove dependencies on mock requests and streamline the setup.
- Enhanced test_generate_title in test_history_service.py to utilize the new v2 agent framework.
- Improved error handling tests in test_chat_service.py for rate limits and general exceptions.
- Consolidated mock setups and assertions for clarity and maintainability.
- Updated 00_create_sample_data_files.py to improve CSV and JSON export functions, ensuring better error handling and code readability.
- Modified 01_create_search_index.py to include additional whitespace for consistency.
- Enhanced 03_cu_process_data_text.py by implementing asynchronous processing for embeddings and agent creation, improving performance and scalability.
- Updated 04_cu_process_custom_data.py to streamline the search index creation process and improve error handling.
- Adjusted requirements.txt to include new agent framework dependencies and ensure compatibility.
- Enhanced process_sample_data.sh and run_create_index_scripts.sh to support new solution_name parameter for better configuration management.
docs: update Technical Architecture diagram
@Pavan-Microsoft Pavan-Microsoft marked this pull request as draft March 9, 2026 12:23
@Pavan-Microsoft Pavan-Microsoft marked this pull request as draft March 9, 2026 12:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants