| | | 1 | | using Intentum.Core.Behavior; |
| | | 2 | | using Intentum.Core.Contracts; |
| | | 3 | | using Intentum.Core.Intents; |
| | | 4 | | |
| | | 5 | | namespace Intentum.Core.Models; |
| | | 6 | | |
| | | 7 | | /// <summary> |
| | | 8 | | /// Wraps an intent model and restricts inference to a sliding time window (configurable window, deterministic for testi |
| | | 9 | | /// Use when you want intent resolution based only on recent events (e.g. last 5 minutes). |
| | | 10 | | /// For decay (recent events weigh more), use an inner model with Intentum.AI.Similarity.TimeDecaySimilarityEngine. |
| | | 11 | | /// </summary> |
| | | 12 | | public sealed class SlidingWindowIntentModel : IIntentModel |
| | | 13 | | { |
| | | 14 | | private readonly IIntentModel _inner; |
| | | 15 | | private readonly TimeSpan _windowSize; |
| | | 16 | | private readonly DateTimeOffset? _referenceTimeForDeterminism; |
| | | 17 | | |
| | | 18 | | /// <summary> |
| | | 19 | | /// Creates a sliding-window intent model. |
| | | 20 | | /// </summary> |
| | | 21 | | /// <param name="inner">The inner intent model (e.g. rule-based or LLM).</param> |
| | | 22 | | /// <param name="windowSize">Time window (e.g. last 5 minutes). Only events within this window are used for inferenc |
| | | 23 | | /// <param name="referenceTimeForDeterminism">Optional: fix the "now" for the window end so that tests are determini |
| | 5 | 24 | | public SlidingWindowIntentModel( |
| | 5 | 25 | | IIntentModel inner, |
| | 5 | 26 | | TimeSpan windowSize, |
| | 5 | 27 | | DateTimeOffset? referenceTimeForDeterminism = null) |
| | 5 | 28 | | { |
| | 5 | 29 | | _inner = inner ?? throw new ArgumentNullException(nameof(inner)); |
| | 5 | 30 | | _windowSize = windowSize; |
| | 5 | 31 | | _referenceTimeForDeterminism = referenceTimeForDeterminism; |
| | 5 | 32 | | } |
| | | 33 | | |
| | | 34 | | /// <inheritdoc /> |
| | | 35 | | public Intent Infer(BehaviorSpace behaviorSpace, BehaviorVector? precomputedVector = null) |
| | 6 | 36 | | { |
| | 6 | 37 | | if (behaviorSpace.Events.Count == 0) |
| | 1 | 38 | | return _inner.Infer(behaviorSpace, precomputedVector); |
| | | 39 | | |
| | 5 | 40 | | var end = _referenceTimeForDeterminism ?? DateTimeOffset.UtcNow; |
| | 5 | 41 | | var start = end - _windowSize; |
| | 5 | 42 | | var eventsInWindow = behaviorSpace.GetEventsInWindow(start, end); |
| | | 43 | | |
| | 5 | 44 | | if (eventsInWindow.Count == 0) |
| | 1 | 45 | | return _inner.Infer(behaviorSpace, precomputedVector); |
| | | 46 | | |
| | 4 | 47 | | var windowedSpace = new BehaviorSpace(); |
| | 26 | 48 | | foreach (var evt in eventsInWindow) |
| | 7 | 49 | | windowedSpace.Observe(evt); |
| | 14 | 50 | | foreach (var kv in behaviorSpace.Metadata) |
| | 1 | 51 | | windowedSpace.SetMetadata(kv.Key, kv.Value); |
| | | 52 | | |
| | 4 | 53 | | return _inner.Infer(windowedSpace, precomputedVector: null); |
| | 6 | 54 | | } |
| | | 55 | | } |