AgentPrismEndpointRouteBuilderExtensions

Namespace AgentPrism · Assembly AgentPrism.AspNetCore.dll

Extensions that connect AgentPrism’s HTTP surface to the application.

public static class AgentPrismEndpointRouteBuilderExtensions

Inheritance

object ← AgentPrismEndpointRouteBuilderExtensions

Inherited Members

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Fields

DefaultPrefix

Default path prefix.

public const string DefaultPrefix = "/agentprism"

Field Value

string

Methods

MapAgentPrism(IEndpointRouteBuilder, string, Action<AgentPrismEndpointOptions>?)

Connects the AgentPrism management API and the OpenAI-compatible run endpoints.

public static IEndpointConventionBuilder MapAgentPrism(this IEndpointRouteBuilder endpoints, string prefix = "/agentprism", Action<AgentPrismEndpointOptions>? configure = null)

Parameters

endpoints IEndpointRouteBuilder

The application’s routing builder.

prefix string

Path prefix. Default is /agentprism.

configure Action<AgentPrismEndpointOptions>?

Hook that mutates access and streaming settings.

Returns

IEndpointConventionBuilder

The convention builder for the protected endpoints. Every convention added only applies to the protected endpoints.

Remarks

Endpoints fall into two groups. {prefix}/api/meta is reachable without authentication; it is needed for the UI to learn which authentication method to use and returns no sensitive data. Every other endpoint passes through the three-layer protection.

The returned builder represents only the protected group. This is deliberate: if the meta endpoint were also locked when the caller writes MapAgentPrism(...).RequireAuthorization, the UI could never learn the authentication method and could never open a session.

app.MapAgentPrism("/agentprism", options =>
{
    options.RequireAuthorization("AgentPrismAdmin");
});

Exceptions

ArgumentNullException

endpoints is null.

ArgumentException

prefix is empty.

InvalidOperationException

AddAgentPrism has not been called.