SDK Parity Update Required

This issue was automatically created by the AI-First workflow to maintain SDK parity.

Source PR Information

Original PR: #110 - Implement Agent Settings SDK for .NET [DO NOT Review, DO NOT Merge]
PR URL: microsoft/Agent365-dotnet#110
PR Author: @Copilot

PR Description

Adds SDK support for managing agent settings templates by agent type and agent instance settings via the Agent 365 platform API.

New Package: Microsoft.Agents.A365.Settings

Models

• AgentSettingsTemplate - Settings template for an agent type
• AgentSettings - Settings for a specific agent instance
• AgentSettingProperty - Individual setting with name, value, type, required flag, description

Service Interface

• IAgentSettingsService - CRUD operations for templates and instance settings

API Endpoints

Usage

// Register via DI
services.AddHttpClient<IAgentSettingsService, AgentSettingsService>();

// Get template
var template = await settingsService.GetSettingsTemplateByAgentTypeAsync("custom-agent", authToken);

// Set instance settings
var settings = new AgentSettings
{
    AgentInstanceId = "instance-123",
    Properties = new List<AgentSettingProperty>
    {
        new() { Name = "maxRetries", Value = "3", Type = "integer", Required = true }
    }
};
await settingsService.SetSettingsByAgentInstanceAsync("instance-123", settings, authToken);

Configuration

• MCP_PLATFORM_ENDPOINT - Override platform base URL (validated for proper URI format)

Tests

24 unit tests covering service methods, model serialization, and error handling.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Parity Task

Changes detected in: csharp SDK
Target SDK: Python (python/)

Action Required

Please apply the changes described in the original PR (#110) to the Python SDK to maintain feature parity across all SDKs.

Before implementing:

• First, check if this feature already exists in the Python SDK
• If the feature is already implemented, close this issue with the wontfix label and add a comment explaining that parity already exists

For bug fixes (IMPORTANT):

• Bug fixes require extra caution - only act if the same bug exists in the Python SDK
• Carefully analyze whether the bug described in the original PR replicates in the target platform
• If the bug does NOT exist in the Python SDK, close this issue with the wontfix label and explain that the bug is not present
• Stay strictly in context - only fix the specific bug described, do not make additional changes or improvements
• Do not port bug fixes that are specific to the source SDK's language or platform constraints

When creating the PR for this implementation:

• Assign the PR to @Copilot (the author of the original PR)
• Reference this issue in the PR description
• Ensure the PR description explains what parity changes were made

Implementation Guidelines for Python

When implementing this feature in the Python SDK:

• Review existing code in python/ to understand the codebase structure and patterns
• Follow the coding style, naming conventions, and architectural patterns used in the Python SDK
• Check for configuration files (e.g., pyproject.toml, .flake8, mypy.ini) that define coding standards
• Ensure your implementation is consistent with existing SDK components
• Include appropriate tests following the testing patterns in the Python SDK

Related Information

• Workflow Run: https://github.com/microsoft/Agent365-dotnet/actions/runs/19651795880
• Trigger: pull_request
• Branch: 110/merge
• Commit: 7b344e7625bae456cd4485a91d0fc693ed0cea0f

This is an automated issue. Please close with wontfix label if parity is not needed.