Structuur van het configuratieobject voor bestanden

Overzicht

Het fileConfig object stelt je in staat om instellingen voor bestandsafhandeling voor de applicatie te configureren, inclusief groottelimieten en beperkingen op MIME-types. Dit gedeelte biedt een gedetailleerd overzicht van de structuur van het fileConfig object.

Er zijn 8 hoofdvelden onder fileConfig:

• endpoints
• serverFileSizeLimit
• avatarSizeLimit
• imageGeneration
• fileTokenLimit
• ocr
• text
• stt

Opmerkingen:

• Op het moment van schrijven ondersteunt de Assistants endpoint bestandstypen uit deze lijst.
• OpenAI, Azure OpenAI, Google en Custom endpoints ondersteunen bestanden via de RAG API.
• OpenAI, Azure OpenAI, Anthropic, Google en AWS Bedrock endpoints ondersteunen directe bestandsuploads via Upload to Provider.
• De ocr-, text- en stt-secties beheren de bestandsverwerking voor functies zoals Upload as Text en OCR
• Alle andere endpoints die niet worden genoemd, zoals Plugins, ondersteunen (nog) geen bestandsuploads.
• Het Assistants endpoint heeft een gedefinieerde endpoint-waarde van assistants. Alle andere endpoints gebruiken de gedefinieerde waarde default
  • Voor niet-assistant endpoints kun je de bestandsinstellingen voor allemaal aanpassen onder default
  • Als je instellingen voor een specifiek endpoint wilt aanpassen, kun je de bijbehorende endpoint-namen vermelden:
    • assistants
      • gebruikt geen "default" omdat het gedefinieerde standaardwaarden heeft die losstaan van de andere.
    • openAI
    • azureOpenAI
    • google
    • bedrock
    • YourCustomEndpointName
• Je kunt waarden weglaten; in dat geval zal de app de standaardwaarden gebruiken zoals gedefinieerd per endpoint type hieronder vermeld.
• LibreChat telt 1 megabyte als volgt: 1 x 1024 x 1024

Voorbeeld

fileConfig:
  endpoints:
    assistants:
      fileLimit: 5
      fileSizeLimit: 10
      totalSizeLimit: 50
      supportedMimeTypes:
        - "image/.*"
        - "application/pdf"
    openAI:
      disabled: true
    default:
      totalSizeLimit: 20
    YourCustomEndpointName:
      fileLimit: 5
      fileSizeLimit: 1000
      supportedMimeTypes:
        - "image/.*"
  serverFileSizeLimit: 1000
  avatarSizeLimit: 2
  fileTokenLimit: 100000
  imageGeneration:
    percentage: 100
    px: 1024
  ocr:
    supportedMimeTypes:
      - "^image/(jpeg|gif|png|webp|heic|heif)$"
      - "^application/pdf$"
      - "^application/vnd\\.openxmlformats-officedocument\\.(wordprocessingml\\.document|presentationml\\.presentation|spreadsheetml\\.sheet)$"
      - "^application/vnd\\.ms-(word|powerpoint|excel)$"
      - "^application/epub\\+zip$"
  text:
    supportedMimeTypes:
      - "^text/(plain|markdown|csv|json|xml|html|css|javascript|typescript|x-python|x-java|x-csharp|x-php|x-ruby|x-go|x-rust|x-kotlin|x-swift|x-scala|x-perl|x-lua|x-shell|x-sql|x-yaml|x-toml)$"
  stt:
    supportedMimeTypes:
      - "^audio/(mp3|mpeg|mpeg3|wav|wave|x-wav|ogg|vorbis|mp4|x-m4a|flac|x-flac|webm)$"

serverFileSizeLimit

fileConfig:
  serverFileSizeLimit: 1000

avatarSizeLimit

fileConfig:
  avatarSizeLimit: 2

imageGeneration

imageGeneration ondersteunt de volgende parameters:

• percentage (Geheel getal)

  • De uitvoergrootte van de gegenereerde afbeelding uitgedrukt als een percentage (bijv. 100 betekent 100% van de basisgrootte).
  • Gebruik dit om de uitvoerafbeelding te schalen ten opzichte van een standaard- of oorspronkelijke grootte.

• px (Geheel getal)

  • Specificeert de uitvoerafmeting van de afbeelding in pixels (bijv. 1024).
  • Gebruik dit om expliciet de uitvoergrootte van de gegenereerde afbeelding in te stellen, ongeacht de basisgrootte.

U mag slechts één van deze parameters (percentage of px) instellen, niet beide, afhankelijk van uw use case.

Voorbeeldconfiguratie:

fileConfig:
  imageGeneration:
    percentage: 100
    px: 1024

fileTokenLimit

Beschrijving: Bij het bijvoegen van tekstinhoud kapt LibreChat de tekst tijdens runtime af op de geconfigureerde tokenlimiet, vlak voordat de prompt wordt opgebouwd.

Standaard: 100000

fileConfig:
  fileTokenLimit: 100000

ocr

Beschrijving: De ocr sectie configureert welke bestandstypen moeten worden verwerkt met behulp van OCR-functionaliteit voor het extraheren van tekst uit visuele documenten.

Let op: Deze sectie beheert de bestandstype-matching voor OCR-verwerking. Om agent-mogelijkheden in te schakelen en OCR-services te configureren, zie:

• Agents Configuration voor de ocr en context capabilities
• OCR Configuration voor de configuratie van de OCR-service

supportedMimeTypes

Standaard: Afbeeldingen, PDF's en Office-documenten

fileConfig:
  ocr:
    supportedMimeTypes:
      - "^image/(jpeg|gif|png|webp|heic|heif)$"
      - "^application/pdf$"
      - "^application/vnd\\.openxmlformats-officedocument\\.(wordprocessingml\\.document|presentationml\\.presentation|spreadsheetml\\.sheet)$"
      - "^application/vnd\\.ms-(word|powerpoint|excel)$"
      - "^application/epub\\+zip$"

text

Beschrijving: De text sectie configureert welke bestandstypen moeten worden verwerkt met behulp van directe tekstextractie.

Let op: Tekstparsing is de standaardmethode die wordt gebruikt door de "Upload als tekst"-functie (aangestuurd door de context capability). Er wordt eerst geprobeerd de tekstparsing-bibliotheek van de RAG API te gebruiken, en als de RAG API niet is verbonden, valt het terug op een eenvoudigere tekstextractiemethode waarvoor geen externe services vereist zijn. Zie Upload als tekst voor meer informatie.

supportedMimeTypes

Standaard: Alle tekstbestanden en algemene programmeertalen

fileConfig:
  text:
    supportedMimeTypes:
      - "^text/(plain|markdown|csv|json|xml|html|css|javascript|typescript|x-python|x-java|x-csharp|x-php|x-ruby|x-go|x-rust|x-kotlin|x-swift|x-scala|x-perl|x-lua|x-shell|x-sql|x-yaml|x-toml)$"

stt

Beschrijving: De stt sectie configureert welke audiobestandstypen moeten worden verwerkt met behulp van Speech-to-Text functionaliteit voor het converteren van audio naar tekst.

supportedMimeTypes

Standaard: Algemene audioformaten

fileConfig:
  stt:
    supportedMimeTypes:
      - "^audio/(mp3|mpeg|mpeg3|wav|wave|x-wav|ogg|vorbis|mp4|x-m4a|flac|x-flac|webm)$"

Opmerkingen:

• Bestanden die overeenkomen met text patronen worden verwerkt met eenvoudige tekstextractie
• Bestanden die overeenkomen met ocr patronen worden verwerkt met de meegeleverde OCR-service
• Bestanden die overeenkomen met stt patronen worden verwerkt met Speech-to-Text transcriptie
• Verwerkingsvolgorde: OCR > STT > tekstverwerking > fallback
• Bestanden die niet overeenkomen met een patroon zullen terugvallen op tekstverwerking

Prioriteit voor bestandsverwerking

LibreChat verwerkt geüploade bestanden op basis van MIME-type matching met de volgende prioriteitsvolgorde:

1. OCR - Als het bestand overeenkomt met ocr.supportedMimeTypes EN OCR is geconfigureerd
2. STT - Als het bestand overeenkomt met stt.supportedMimeTypes EN STT is geconfigureerd
3. Tekstverwerking - Als het bestand overeenkomt met text.supportedMimeTypes
4. Fallback - Tekstparsering als laatste redmiddel

Deze verwerkingsvolgorde zorgt voor een optimale extractiekwaliteit, terwijl de functionaliteit behouden blijft, zelfs wanneer gespecialiseerde services (OCR/STT) niet zijn geconfigureerd.

Verwerkingsvoorbeelden

PDF-bestand met geconfigureerde OCR:

• Bestand komt overeen met ocr.supportedMimeTypes
• Gebruikt OCR om tekst te extraheren
• Betere kwaliteit voor gescande PDF's en afbeeldingen

PDF-bestand zonder geconfigureerde OCR:

• Bestand komt overeen met text.supportedMimeTypes (of gebruikt fallback)
• Gebruikt de text parsing library
• Werkt goed voor digitale PDF's met selecteerbare tekst

Python-bestand:

• Bestand komt overeen met text.supportedMimeTypes
• Gebruikt tekstparsing (geen OCR nodig)
• Directe tekstextractie

Audiobestand met STT geconfigureerd:

• Bestand komt overeen met stt.supportedMimeTypes
• Gebruikt STT om audio naar tekst te transcriberen

Afbeeldingsbestand zonder geconfigureerde OCR:

• Bestand komt overeen met ocr.supportedMimeTypes maar OCR is niet beschikbaar
• Valt terug op tekstverwerking
• Beperkte extractiemogelijkheden zonder OCR

Dit prioriteitssysteem zorgt ervoor dat functies zoals "Upload as Text" werken zonder dat OCR-configuratie vereist is, terwijl er toch gebruik wordt gemaakt van OCR wanneer dit beschikbaar is voor een verbeterde extractiekwaliteit.

endpoints

Beschrijving: Elk object onder endpoints is een record dat de volgende instellingen kan bevatten:

Overzicht

• disabled
  • Of bestandsafhandeling is uitgeschakeld voor de endpoint.
• fileLimit
  • Het maximale aantal bestanden dat is toegestaan per uploadverzoek.
• fileSizeLimit
  • De maximale grootte voor een enkel bestand. In eenheden van MB (gebruik bijvoorbeeld 20 voor 20 megabyte)
• totalSizeLimit
  • De totale maximale grootte voor alle bestanden in één verzoek. In eenheden van MB (gebruik bijvoorbeeld 20 voor 20 megabyte)
• supportedMimeTypes
  • Een lijst met Regular Expressions die specificeert welke MIME-types zijn toegestaan voor uploads. Dit kan worden aangepast om bestandstypen te beperken.

disabled

Standaard: false

openAI:
  disabled: true

fileLimit

Sleutel:

Standaard: Varieert per endpoint

assistants:
  fileLimit: 5

fileSizeLimit

Sleutel:

Standaard: Varieert per endpoint

YourCustomEndpointName:
  fileSizeLimit: 1000

totalSizeLimit

Sleutel:

Standaard: Varieert per endpoint

assistants:
  totalSizeLimit: 50

supportedMimeTypes

Sleutel:

Standaard: Varieert per endpoint

assistants:
  supportedMimeTypes:
      - "image/.*"
      - "application/pdf"