manager-service/ManagerService/Services/IVectorStoreService.cs
Thomas Fransolet 18e4240f0f RAG: pipeline d'ingestion, endpoints du guide IA, journalisation RGPD
Ingestion et indexation
- IIngestionService/IngestionService : chargement des collections filles par
  sous-type, un jeu de morceaux par langue, ChunkIndex continu.
- SectionIndexingInterceptor retenu comme unique déclencheur : les 5
  sous-contrôleurs totalisaient 30 SaveChanges et 0 Enqueue, donc ajouter des
  points d'intérêt à une carte ne réindexait rien.
- HTML retiré avant l'embedding et lignes trop longues recoupées : sans cela un
  article dépassait l'entrée max du modèle et emportait son lot de 50 morceaux.
- Gabarits de LanguageInit filtrés, DistinctBy(Text) avant le Take : ils
  occupaient les cinq premiers résultats d'une recherche en néerlandais.

Endpoints du guide IA
- GET /api/Ai/knowledge/{id} : agrégats sur ContentEmbedding, donc sur ce qui
  est réellement indexé — compter les sections publiées serait plus flatteur et faux.
- GET /api/Ai/insights/{id} : miroir de GuideIaInsights côté manager-app, c'est
  l'écran qui a fixé la forme pour que le job de thèmes la remplisse.

RGPD
- VisitorQuestion journalisée dans AiController.Chat. HasAnswer se déduit des
  sources du retrieval, pas du texte : un repli poli ressemble à une réponse.
  L'écriture n'échoue jamais la réponse au visiteur.
- VisitorQuestionPurgeService, 90 jours, actif sans condition de configuration :
  une durée écrite dans les CGU n'est pas un réglage commercial.

Corrections
- Updateinstance ne recopiait pas les quotas du nouveau plan.
- CheckQuota ne bloquait ni ne comptait à quota 0 — IA gratuite non comptée.
- StoragePath et SizeBytes renseignés à Create, types URL exclus.

dotnet build 0 erreur, dotnet test 130/130.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-11 10:48:10 +02:00

49 lines
2.2 KiB
C#

using ManagerService.Data;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
namespace ManagerService.Services
{
/// <summary>
/// Lecture et écriture des morceaux de contenu indexés pour le guide IA.
/// </summary>
public interface IVectorStoreService
{
/// <summary>
/// Remplace tous les morceaux d'un contenu. Le nombre de morceaux change d'une version
/// à l'autre : mettre à jour morceau par morceau laisserait des fantômes qui continueraient
/// d'alimenter les réponses avec du contenu supprimé. Une liste vide purge le contenu.
/// </summary>
Task ReplaceAsync(string instanceId, string configurationId, string contentId,
ContentSourceType contentType, IReadOnlyList<ContentChunk> chunks,
CancellationToken cancellationToken = default);
/// <summary>
/// Cherche les morceaux les plus proches de la question.
/// Le seul filtre dur est l'instance. La langue ne filtre pas — un visiteur néerlandophone
/// doit retrouver une brochure qui n'existe qu'en français : le modèle d'embedding est
/// multilingue et la traduction se fait à la rédaction de la réponse.
/// <paramref name="language"/> et <paramref name="currentConfigurationId"/> ne servent
/// qu'à bonifier le classement.
/// <paramref name="topK"/> null retombe sur <c>AI:SearchTopK</c>.
/// </summary>
Task<List<VectorSearchResult>> SearchAsync(string instanceId, string currentConfigurationId,
string language, string query, int? topK = null,
CancellationToken cancellationToken = default);
Task DeleteAsync(string contentId, ContentSourceType contentType,
CancellationToken cancellationToken = default);
}
public record ContentChunk(string Text, int ChunkIndex, int? PageNumber, string Language);
public record VectorSearchResult(
string ContentId,
ContentSourceType ContentType,
string Text,
int? PageNumber,
string Language,
double Score);
}