Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

Struktura obiektu filtra wiadomości

Przegląd

Obiekt messageFilter konfiguruje serwerowe filtry wiadomości. W wersji v1.3.13 obsługiwanym typem filtra jest messageFilter.pii.

messageFilter.pii odrzuca przesłany tekst wiadomości, który pasuje do wzorców przypominających dane uwierzytelniające lub wyrażeń regularnych zdefiniowanych przez operatora, zanim tekst trafi do moderacji, żądania do modelu lub utrwalenia wiadomości.

Przykład

messageFilter:
  pii:
    starterPatterns:
      - sk_prefix
      - bearer_header
      - api_key_header
    customPatterns:
      - id: anthropic_api_key
        label: Anthropic API key
        regex: 'sk-ant-[A-Za-z0-9_-]{20,}'

Pola

messageFilter.pii

KeyTypeDescriptionExample
pii.starterPatternsArray of StringsOpcjonalny podzbiór wbudowanych identyfikatorów wzorców startowych do włączenia. Pomiń, aby włączyć wszystkie wzorce startowe.starterPatterns: [sk_prefix, bearer_header]
pii.customPatternsArray of ObjectsWzorce zdefiniowane przez operatora. Każdy wpis wymaga `id`, `label` oraz `regex`.

Wbudowane identyfikatory wzorców startowych:

  • sk_prefix: dopasowuje prefiksy tokenów w stylu sk-.
  • bearer_header: dopasowuje tokeny bearer w tekście.
  • api_key_header: dopasowuje tekst w formacie nagłówka api-key.

customPatterns

KeyTypeDescriptionExample
idStringStabilny identyfikator wzorca używany do logów i debugowania.id: anthropic_api_key
labelStringCzytelna dla człowieka etykieta wyświetlana w komunikacie o odrzuceniu.label: Anthropic API key
regexStringWyrażenie regularne w stylu JavaScript. LibreChat weryfikuje je podczas ładowania konfiguracji i kompiluje z flagą globalną.regex: 'sk-ant-[A-Za-z0-9_-]{20,}'

Zachowanie

Gdy przesłany tekst wiadomości pasuje do skonfigurowanego wzorca PII, LibreChat zwraca kod HTTP 400 wraz z message_filter_pii_block oraz komunikatem proszącym użytkownika o usunięcie dopasowanego typu danych uwierzytelniających.

Filtr sprawdza:

  • Tekst użytkownika trasy czatu przesłany przez interfejs użytkownika LibreChat.
  • Treść tekstu we wszystkich rolach wiadomości dostarczonych przez wywołującego w żądaniach Chat Completions zgodnych z OpenAI.
  • Treść tekstowa we wszystkich rolach wiadomości dostarczonych przez wywołującego w żądaniach odpowiedzi zgodnych z OpenAI.

Filtr ocenia tekst dostarczony w treści żądania. Nie skanuje on zawartości plików.

Jaka jest ta instrukcja?