IAgentFactory

IAgentFactory Interface¶

Factory for creating configured Microsoft.Agents.AI.AIAgent instances with auto-discovered AgentFunctionAttribute tools wired up.

public interface IAgentFactory

Creates a new Microsoft.Agents.AI.AIAgent by looking up the registered type for agentClassName and reading its NeedlrAiAgentAttribute.

Microsoft.Agents.AI.AIAgent CreateAgent(string agentClassName);

agentClassName System.String

The simple class name of an agent type registered via AddAgent<T>(), AddAgentsFromGenerated(), or the source generator bootstrap.

System.InvalidOperationException
Thrown when no agent with the given name is registered.

Creates a new Microsoft.Agents.AI.AIAgent with the registered function tools applied.

Microsoft.Agents.AI.AIAgent CreateAgent(System.Action<NexusLabs.Needlr.AgentFramework.AgentFactoryOptions>? configure=null);

Optional callback to configure per-agent options such as instructions or a subset of function types to wire for this specific agent instance.

Creates a new Microsoft.Agents.AI.AIAgent by reading configuration directly from the NeedlrAiAgentAttribute on TAgent.

Microsoft.Agents.AI.AIAgent CreateAgent<TAgent>()
    where TAgent : class;

TAgent

A class decorated with NeedlrAiAgentAttribute. The class name becomes the agent's Name.