dify-knowledge-base-upload
/dify-knowledge-base-upload
Wgrywa lokalne pliki do bazy wiedzy potoku Dify przez opublikowany przepływ datasource i opcjonalnie stosuje istniejące pola metadanych.
- Autor
- tiangong-ai ↗
- Repozytorium
- agent-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 20.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 8
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 20.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/upload_to_dataset.py
Co robi i kiedy
Wgrywa lokalne pliki do bazy wiedzy potoku Dify przez opublikowany przepływ datasource i opcjonalnie stosuje istniejące pola metadanych.
Oryginalny opis (EN)
Upload local files to a Dify pipeline knowledge base through the published pipeline datasource flow and optionally apply existing metadata fields. Use when the target dataset is a published rag_pipeline/local_file knowledge base or ordinary Dify document create APIs return completed with 0 chunks.
Jak działa
- Use this skill when
- Prepare caller-side inputs
- Run workflow
- Interpret response
- Troubleshoot quickly
- References
- Assets
Podgląd SKILL.md
---
name: dify-knowledge-base-upload
description: Upload local files to a Dify pipeline knowledge base through the published pipeline datasource flow and optionally apply existing metadata fields. Use when the target dataset is a published rag_pipeline/local_file knowledge base or ordinary Dify document create APIs return completed with 0 chunks.
---
# Dify Knowledge Base Upload
## Use this skill when
- The target Dify knowledge base is backed by a published pipeline datasource.
- UI uploads succeed but `document/create-by-file` or `create-by-text` yields `completed` with `0 chunks`.
- You need to upload one local file and optionally write existing metadata fields afterward.
## Prepare caller-side inputs
- Provide a local file path to upload.
- For pure text, save it as `.txt` or `.md` first and upload that file.
- Set caller env values:
- `DIFY_API_BASE_URL`
- `DIFY_DATASET_ID`
- `DIFY_API_KEY`
- Optionally provide pipeline `inputs` JSON if the published pipeline exposes user input variables.
- Optionally provide metadata JSON:
- a flat object mapping existing Dify metadata field names to values, or
- a list of `{ "name": ..., "value": ... }` / `{ "id": ..., "value": ... }` items.
- The skill does not hardcode your metadata schema. Pass the current field names or ids in the JSON you provide at runtime.
- Read `references/env.md` only if you need env or debug details.
## Run workflow
- Use `scripts/upload_to_dataset.py` to:
- discover the published datasource plugin from `${DIFY_API_BASE_URL}/datasets/${DIFY_DATASET_ID}/pipeline/datasource-plugins?is_published=true`
- upload the file to `${DIFY_API_BASE_URL}/datasets/pipeline/file-upload`
- run the published pipeline through `${DIFY_API_BASE_URL}/datasets/${DIFY_DATASET_ID}/pipeline/run`
- poll `${DIFY_API_BASE_URL}/datasets/${DIFY_DATASET_ID}/documents/{batch}/indexing-status`
- fetch `${DIFY_API_BASE_URL}/datasets/${DIFY_DATASET_ID}/documents/{document_id}?metadata=without`
- optionally resolve metadata field names through `${DIFY_API_BASE_URL}/datasets/${DIFY_DATASET_ID}/metadata`
- optionally update metadata through `${DIFY_API_BASE_URL}/datasets/${DIFY_DATASET_ID}/documents/metadata`
- Upload without metadata:
```bash
python3 scripts/upload_to_dataset.py \
--file /path/to/document.pdf
```
- Upload with pipeline inputs:
```bash
python3 scripts/upload_to_dataset.py \
--file /path/to/document.pdf \
--inputs-json assets/example-pipeline-inputs.json
```
- Upload and then apply metadata:
```bash
python3 scripts/upload_to_dataset.py \
--file /path/to/document.pdf \
--metadata-json assets/example-metadata.json
```
## Interpret response
- Success prints JSON with `batch`, `document_id`, `file_upload_response`, `pipeline_run_response`, `indexing_status_response`, `document_response`, optional `metadata_response`, and `validation`.
- `validation.ok` is only true when:
- `indexing_status = "completed"`
- `total_segments > 0`
- `segment_count > 0`
- If `tokens` is returned by the document detail API, it should also be greater than `0`. Some pipeline deployments leave `tokens = null`; the script reports that as a warning instead of a hard failure.
- The script exits non-zero if the required checks fail.
- If `--metadata-json` is omitted, the script uploads the file only and skips metadata API calls.
- Metadata keys must already exist in the target dataset. Unknown names fail fast before the metadata write request.
- `assets/example-metadata.json` is only a template. Replace its keys with your own existing Dify metadata field names before live use.
- Use `--dry-run` to validate local files and request shape without calling Dify.
## Troubleshoot quickly
- If auth fails, verify `DIFY_API_KEY` and `Authorization` header format.
- If datasource discovery fails, verify the dataset has a published pipeline datasource and the key belongs to that dataset.
- If the pipeline run fails with missing input errors, inspect `user_input_variables` from `discovery_response` and pass the missing keys in `--inputs-json`.
- If the published datasource is not `local_file`, this skill is not the right uploader.
- If metadata resolution fails, rename keys in the metadata JSON to the exact field names defined in Dify.
- If you only have raw text, save it to `.txt` or `.md` and upload that file.
- In the current tested deployment, `.md` uploaded successfully while `.txt` hit a Dify-side indexing `400`. If plain text fails as `.txt`, retry as `.md`.
## References
- `references/env.md`
- `references/request-response.md`
- `references/testing.md`
## Assets
- `assets/example-pipeline-inputs.json`
- `assets/example-metadata.json`
Pliki w paczce (8)
- SKILL.md 5 KB
- agents/openai.yaml 1 KB
- assets/example-metadata.json 1 KB
- assets/example-pipeline-inputs.json 1 KB
- references/env.md 2 KB
- references/request-response.md 4 KB
- references/testing.md 2 KB
- scripts/upload_to_dataset.py 31 KB
Wersje
W bazie nie ma innych skilli o nazwie dify-knowledge-base-upload.
Identyczna treść występuje jeszcze w 2 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki d918b0f0cb05 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100dify-knowledge-base-search
Obsługuje API wyszukiwania w bazie wiedzy Dify (dataset retrieve): testowanie fragmentów, opcje retrieval_model i kształt odpowiedzi. - 100dify
Pomaga z Dify: hostowanie przez Docker Compose, zmienne środowiskowe, wywołania API aplikacji i workflow, dokumenty w bazie wiedzy, eksport i import DSL, difyctl oraz aktualizacja i kopie zapasowe. - 100dify-workflow
Projektuje i generuje DSL aplikacji Dify (workflow, advanced-chat), a następnie wdraża go na instancję Dify przez Admin API. - 100validate-dify-dsl
Sprawdza węzły główne pliku DSL Dify, czyli eksportu przepływu w YAML, i wskazuje niepoprawne pola w każdym węźle. - 100skills-to-dify-workflow
Przekształca foldery skilli Claude Code w pliki YAML workflow Dify i tworzy podgląd React przed eksportem. - 100dify-chatflow-builder
Pomaga budować wielokrotne dialogi w Dify: przepływy, maszyny stanów, węzły, zmienne i prompty, a także rozwiązywać błędy uruchomienia.