Add Agent Settings Service for template and instance configuration management #168

Copilot · 2026-01-05T21:55:41Z

Implements the Agent Settings API for managing agent configuration templates by type and instance-specific settings to achieve SDK parity with microsoft/Agent365-nodejs#130.

Changes

Models

AgentSettingTemplate - Template configuration keyed by agent type
AgentSettings - Instance-specific configuration keyed by agent instance ID
Both support Dictionary<string, object?> settings and optional metadata

Service

AgentSettingsService - HTTP client for Power Platform Agent Settings API
- GetAgentSettingTemplateAsync/SetAgentSettingTemplateAsync - Template CRUD by agent type
- GetAgentSettingsAsync/SetAgentSettingsAsync - Instance settings CRUD by agent instance ID
Constructs tenant-specific endpoints via PowerPlatformApiDiscovery
Uses consistent JSON serialization options (camelCase, case-insensitive deserialization)
Returns null on 404, throws on other HTTP errors

Endpoints

/agents/v1.0/settings/templates/{agentType}
/agents/v1.0/settings/instances/{agentInstanceId}

Usage

var apiDiscovery = new PowerPlatformApiDiscovery("prod");
var service = new AgentSettingsService(apiDiscovery, tenantId, httpClient);

// Template management
var template = await service.GetAgentSettingTemplateAsync("my-agent-type", token);
await service.SetAgentSettingTemplateAsync(new AgentSettingTemplate
{
    AgentType = "my-agent-type",
    Settings = new Dictionary<string, object?> { ["maxRetries"] = 3 }
}, token);

// Instance settings management
var settings = await service.GetAgentSettingsAsync(instanceId, token);
await service.SetAgentSettingsAsync(new AgentSettings
{
    AgentInstanceId = instanceId,
    AgentType = "my-agent-type",
    Settings = new Dictionary<string, object?> { ["endpoint"] = "https://..." }
}, token);

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

il-000000000000000000000000000000.00.tenant.api.powerplatform.com
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenan.t1.tenant.api.powerplatform.com
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenant1.23.tenant.api.powerplatform.com
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenant12.3.tenant.api.appsplatform.us
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenant12.3.tenant.api.gov.powerplatform.microsoft.us
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenant12.3.tenant.api.high.powerplatform.microsoft.us
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenant12.3.tenant.api.powerplatform.eaglex.ic.gov
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenant12.3.tenant.api.powerplatform.microsoft.scloud
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenant12.3.tenant.api.powerplatform.partner.microsoftonline.cn
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenantdiscoverynos.et.tenant.api.powerplatform.com
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenante.nv.tenant.api.powerplatform.com
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
il-tenantenvoverrid.es.tenant.api.powerplatform.com
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)
override.example.com
- Triggering command: /usr/share/dotnet/dotnet /usr/share/dotnet/dotnet exec --runtimeconfig /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.runtimeconfig.json --depsfile /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/Microsoft.Agents.A365.Observability.Runtime.Tests.deps.json /home/REDACTED/work/Agent365-dotnet/Agent365-dotnet/src/Tests/Microsoft.Agents.A365.Observability.Runtime.Tests/bin/Debug/net8.0/testhost.dll --port 42295 --endpoint 127.0.0.1:042295 --role client --parentprocessid 6496 --telemetryoptedin false (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Configure Actions setup steps to set up my environment, which run before the firewall is enabled
Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

This section details on the original issue you should resolve

<issue_title>[SDK Parity] .NET/C# for PR microsoft/Agent365-nodejs#130</issue_title>
<issue_description>## SDK Parity Update Required

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

Source PR Information

Original PR: microsoft/Agent365-nodejs#130 - Add Agent Settings Service with template and instance management
PR URL: microsoft/Agent365-nodejs#130
PR Author: @app/copilot-swe-agent

PR Description

Implements the Agent Settings API for managing agent configuration templates by type and instance-specific settings.## Changes- AgentSettingsService - New service class in @microsoft/agents-a365-runtime with methods: - getAgentSettingTemplate/setAgentSettingTemplate - Manage templates by agent type - getAgentSettings/setAgentSettings - Manage settings by agent instance ID - Type definitions - AgentSettingTemplate and AgentSettings interfaces with settings as Record<string, unknown> and optional metadata- Endpoints - Constructs Power Platform API URLs: - /agents/v1.0/settings/templates/{agentType} - /agents/v1.0/settings/instances/{agentInstanceId}## Usagetypescriptimport { AgentSettingsService, PowerPlatformApiDiscovery } from '@microsoft/agents-a365-runtime';const service = new AgentSettingsService( new PowerPlatformApiDiscovery('prod'), tenantId);// Manage templatesconst template = await service.getAgentSettingTemplate('my-agent-type', token);await service.setAgentSettingTemplate({ agentType: 'my-agent-type', settings: { key: 'value' }}, token);// Manage instance settingsconst settings = await service.getAgentSettings('instance-id', token);await service.setAgentSettings({ agentInstanceId: 'instance-id', agentType: 'my-agent-type', settings: { instanceKey: 'value' }}, token);
Original prompt
> Implementing the Agents Settings for NodeJS> > See attached swagger file for more information on this API.> > This currently API supports:> > GET or SET agent setting template by agent type> > GET or SET agent settings by agent instance.> > https://github.com/user-attachments/files/23107469/swagger.json
---💡 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: Node.js/TypeScript SDK
Target SDK: .NET/C#

Action Required

Please apply the changes described in the original PR (microsoft/Agent365-nodejs#130) to the .NET/C# SDK to maintain feature parity across all SDKs.

Before implementing:

First, check if this feature already exists in the .NET/C# 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 .NET/C# SDK

Carefully analyze whether the bug described in the original PR replicates in the target platform

If the bug does NOT exist in the .NET/C# 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 @app/copilot-swe-agent (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 .NET/C#

When implementing this feature in the .NET SDK:

Review existing code in dotnet/sdk/ to understand the codebase structure and patterns

Follow the coding style, naming conventions, and architectural patterns used in the .NET SDK

Check for configuration files (e.g., .editorconfig, Directory.Build.props) that define coding standards

Ensure your implementation is consistent with existing SDK components

Include appropriate tests following the testing patterns in the .NET SDK

Related Information

Workflow Run: https://github.com/microsoft/Agent365/actions/runs/20730347624

Trigger: Polling workflow

Detected: 2026-01-05 21:55:32 UTC

This is an automated issue. Please close with wontfix label if parity is not needed.</issue_description>

Comments on the Issue (you are @copilot in this section)

Fixes [SDK Parity] .NET/C# for PR microsoft/Agent365-nodejs#130 #167

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Co-authored-by: sergioescalera <[email protected]>

…documentation Co-authored-by: sergioescalera <[email protected]>

Initial plan

1460117

Copilot AI assigned Copilot and sergioescalera Jan 5, 2026

Copilot started work on behalf of sergioescalera January 5, 2026 21:56 View session

Copilot AI and others added 2 commits January 5, 2026 22:05

Add AgentSettingsService with models and tests

70182d7

Co-authored-by: sergioescalera <[email protected]>

Address code review feedback - add JsonSerializerOptions and improve …

0e0c20e

…documentation Co-authored-by: sergioescalera <[email protected]>

Copilot AI changed the title ~~[WIP] Update SDK parity for Agent Settings Service in .NET~~ Add Agent Settings Service for template and instance configuration management Jan 5, 2026

Copilot AI requested a review from sergioescalera January 5, 2026 22:13

Copilot finished work on behalf of sergioescalera January 5, 2026 22:13

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Add Agent Settings Service for template and instance configuration management #168

Add Agent Settings Service for template and instance configuration management #168

Uh oh!

Copilot AI commented Jan 5, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Add Agent Settings Service for template and instance configuration management #168

Are you sure you want to change the base?

Add Agent Settings Service for template and instance configuration management #168

Uh oh!

Conversation

Copilot AI commented Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Usage

I tried to connect to the following addresses, but was blocked by firewall rules:

Source PR Information

PR Description

Parity Task

Action Required

Implementation Guidelines for .NET/C#

Related Information

Comments on the Issue (you are @copilot in this section)

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Jan 5, 2026 •

edited

Loading