LangfuseExperimentItemScopeExtensions

NexusLabs.Foundry.Langfuse

LangfuseExperimentItemScopeExtensions Class

Creates provider-neutral experiment item scopes from the built-in Langfuse client or session.

public static class LangfuseExperimentItemScopeExtensions

Inheritance System.Object 🡒 LangfuseExperimentItemScopeExtensions

Methods

LangfuseExperimentItemScopeExtensions.CreateExperimentItemScopeProvider<TCase,TOutput>(this ILangfuseClient, ILangfuseExperimentRun) Method

Creates an item-scope provider that links each statistical trial to the supplied hosted Langfuse experiment run using default trace and publication behavior.

public static NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeProvider<TCase,TOutput> CreateExperimentItemScopeProvider<TCase,TOutput>(this NexusLabs.Foundry.Langfuse.ILangfuseClient client, NexusLabs.Foundry.Langfuse.ILangfuseExperimentRun run);

Type parameters

TCase

The caller-owned case value type.

TOutput

The caller-owned output type.

Parameters

client ILangfuseClient

The built-in Langfuse client or session.

run ILangfuseExperimentRun

The run that owns shared dataset-run identity and publication state.

Returns

NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeProvider<TCase,TOutput>
The item-scope provider to add to an experiment definition.

Exceptions

System.ArgumentNullException
client or run is null.

System.NotSupportedException
client does not expose the built-in Langfuse trial lifecycle.

System.ArgumentException
run does not expose the built-in Langfuse trial lifecycle.

LangfuseExperimentItemScopeExtensions.CreateExperimentItemScopeProvider<TCase,TOutput>(this ILangfuseClient, ILangfuseExperimentRun, LangfuseExperimentItemScopeOptions<TCase>) Method

Creates an item-scope provider that links each statistical trial to the supplied hosted Langfuse experiment run using explicit trace and publication behavior.

public static NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeProvider<TCase,TOutput> CreateExperimentItemScopeProvider<TCase,TOutput>(this NexusLabs.Foundry.Langfuse.ILangfuseClient client, NexusLabs.Foundry.Langfuse.ILangfuseExperimentRun run, NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeOptions<TCase> options);

Type parameters

TCase

The caller-owned case value type.

TOutput

The caller-owned output type.

Parameters

client ILangfuseClient

The built-in Langfuse client or session.

run ILangfuseExperimentRun

The run that owns shared dataset-run identity and publication state.

options NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeOptions<TCase>

The trace and publication behavior.

Returns

NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeProvider<TCase,TOutput>
The item-scope provider to add to an experiment definition.

Exceptions

System.ArgumentNullException
client, run, or options is null.

System.NotSupportedException
client does not expose the built-in Langfuse trial lifecycle.

System.ArgumentException
run does not expose the built-in Langfuse trial lifecycle.

LangfuseExperimentItemScopeExtensions.CreateLocalExperimentItemScopeProvider<TCase,TOutput>(this ILangfuseClient) Method

Creates an item-scope provider that records one trace per statistical trial without creating a Langfuse dataset run, using default trace and publication behavior.

public static NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeProvider<TCase,TOutput> CreateLocalExperimentItemScopeProvider<TCase,TOutput>(this NexusLabs.Foundry.Langfuse.ILangfuseClient client);

Type parameters

TCase

The caller-owned case value type.

TOutput

The caller-owned output type.

Parameters

client ILangfuseClient

The built-in Langfuse client or session.

Returns

NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeProvider<TCase,TOutput>
The local trace-only item-scope provider.

Exceptions

System.ArgumentNullException
client is null.

System.NotSupportedException
client does not expose the built-in Langfuse trial lifecycle.

LangfuseExperimentItemScopeExtensions.CreateLocalExperimentItemScopeProvider<TCase,TOutput>(this ILangfuseClient, LangfuseExperimentItemScopeOptions<TCase>) Method

Creates an item-scope provider that records one trace per statistical trial without creating a Langfuse dataset run, using explicit trace and publication behavior.

public static NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeProvider<TCase,TOutput> CreateLocalExperimentItemScopeProvider<TCase,TOutput>(this NexusLabs.Foundry.Langfuse.ILangfuseClient client, NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeOptions<TCase> options);

Type parameters

TCase

The caller-owned case value type.

TOutput

The caller-owned output type.

Parameters

client ILangfuseClient

The built-in Langfuse client or session.

options NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeOptions<TCase>

The trace and publication behavior.

Returns

NexusLabs.Foundry.Langfuse.LangfuseExperimentItemScopeProvider<TCase,TOutput>
The local trace-only item-scope provider.

Exceptions

System.ArgumentNullException
client or options is null.

System.NotSupportedException
client does not expose the built-in Langfuse trial lifecycle.