paperless-ngx
Interact with Paperless-ngx document management system via REST API. Use when users want to search, upload, download, organize documents, manage tags, correspondents, or document types in their Paperless-ngx instance.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Interact with Paperless-ngx document management system via REST API. Use when users want to search, upload, download, organize documents, manage tags, correspondents, or document types in their Paperless-ngx instance.
How to use
Przygotuj dostęp do instancji Paperless-ngx. Upewnij się, że masz dostęp do adresu URL serwera (np. https://paperless.example.com) i wygeneruj token API w ustawieniach Paperless-ngx.
Skonfiguruj zmienne środowiskowe wymagane przez umiejętność: PAPERLESS_URL (adres bazowy Twojej instancji) i PAPERLESS_TOKEN (token API). Te zmienne będą automatycznie dołączane do każdego żądania.
Aby wyszukać dokumenty, poproś agenta o znalezienie plików po słowach kluczowych, dacie utworzenia lub tagach. Agent wyśle zapytanie do API z parametrami filtru (np. correspondent__id, document_type__id, tags__id__in, daty) i zwróci listę pasujących dokumentów.
Aby przesłać nowy dokument, podaj ścieżkę do pliku oraz opcjonalne metadane: tytuł, datę utworzenia, kontrahenta, typ dokumentu i tagi. Agent wyśle plik na serwer Paperless-ngx z przypisanymi atrybutami.
Aby pobrać dokument, wskaż jego ID. Agent może pobrać wersję oryginalną lub zeskanowaną (OCR'd) — wybór zależy od Twoich potrzeb.
Aby zmienić metadane istniejącego dokumentu (np. dodać tag, zmienić kontrahenta), podaj ID i nowe wartości. Agent wyśle żądanie PATCH z zaktualizowanymi danymi.