mirror of
https://github.com/microsoft/agent-framework.git
synced 2026-06-16 21:04:09 +08:00
96d242fa7f
* Move token params from HarnessAgent constructor to options Remove the required maxContextWindowTokens and maxOutputTokens constructor parameters from HarnessAgent and AsHarnessAgent, replacing them with optional MaxContextWindowTokens and MaxOutputTokens properties on HarnessAgentOptions. When both values are provided, compaction is enabled as before (in-loop CompactionProvider and chat reducer on the default InMemoryChatHistory Provider). When either is null, compaction is disabled entirely, making it opt-in. New constructor: HarnessAgent(IChatClient, HarnessAgentOptions?, ILoggerFactory?, IServiceProvider?) Closes #6333 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Improving comments. * feat: Add custom CompactionStrategy and DisableCompaction to HarnessAgentOptions Allow users to provide their own CompactionStrategy via options, with a clear priority system: 1. DisableCompaction=true: no compaction regardless of other settings 2. Custom CompactionStrategy provided: use it (token params ignored) 3. Both MaxContextWindowTokens and MaxOutputTokens set: default strategy 4. Otherwise: no compaction Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * fix: Address PR review comments on compaction opt-in - Update chatClient param XML doc to reflect compaction is opt-in - Strengthen compaction tests to assert ChatReducer is null/not-null rather than just asserting construction succeeds Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
44 lines
1.9 KiB
C#
44 lines
1.9 KiB
C#
// Copyright (c) Microsoft. All rights reserved.
|
|
|
|
using System;
|
|
using System.Diagnostics.CodeAnalysis;
|
|
using Microsoft.Agents.AI;
|
|
using Microsoft.Extensions.Logging;
|
|
using Microsoft.Shared.DiagnosticIds;
|
|
|
|
namespace Microsoft.Extensions.AI;
|
|
|
|
/// <summary>
|
|
/// Provides extension methods for creating a <see cref="HarnessAgent"/> from an <see cref="IChatClient"/>.
|
|
/// </summary>
|
|
[Experimental(DiagnosticIds.Experiments.AgentsAIExperiments)]
|
|
public static class ChatClientHarnessExtensions
|
|
{
|
|
/// <summary>
|
|
/// Creates a new <see cref="HarnessAgent"/> that wraps this <see cref="IChatClient"/> with a pre-configured
|
|
/// pipeline including function invocation, per-service-call chat history persistence, optional in-loop compaction, and a rich set
|
|
/// of default context providers and agent decorators.
|
|
/// </summary>
|
|
/// <param name="chatClient">
|
|
/// The <see cref="IChatClient"/> that provides access to the underlying AI model.
|
|
/// </param>
|
|
/// <param name="options">
|
|
/// Optional configuration options for the agent, including instructions override, tools,
|
|
/// additional context providers, chat history provider, and compaction settings.
|
|
/// When <see langword="null"/>, the agent uses built-in default settings with compaction disabled.
|
|
/// </param>
|
|
/// <param name="loggerFactory">
|
|
/// Optional logger factory for creating loggers used by the agent and its components.
|
|
/// </param>
|
|
/// <param name="services">
|
|
/// Optional service provider for resolving dependencies required by AI functions and other agent components.
|
|
/// </param>
|
|
/// <returns>A new <see cref="HarnessAgent"/> instance.</returns>
|
|
public static HarnessAgent AsHarnessAgent(
|
|
this IChatClient chatClient,
|
|
HarnessAgentOptions? options = null,
|
|
ILoggerFactory? loggerFactory = null,
|
|
IServiceProvider? services = null) =>
|
|
new(chatClient, options, loggerFactory, services);
|
|
}
|