dify-knowledge-base-search — скилл для Claude Code: поиск в Dify
Скилл dify-knowledge-base-search проверяет поиск чанков через Dify dataset retrieve API и помогает разбирать запросы, параметры retrieval_model и ответы.
MIT 114 установок ★ 11 обновлён 2026-10-19
npx skills add tiangong-ai/agent-skills --skill dify-knowledge-base-search -a claude-codeЧто делает dify-knowledge-base-search
Скилл задаёт порядок проверки Dify Knowledge Base Search: агент принимает JSON с query и необязательным retrieval_model.top_k, формирует POST-запрос к /datasets/${DIFY_DATASET_ID}/retrieve и передаёт Authorization: Bearer $DIFY_API_KEY. Шаблон тела запроса лежит в assets/example-request.json.
Для работы нужны DIFY_API_BASE_URL, DIFY_DATASET_ID и DIFY_API_KEY; базовый URL должен содержать /v1. Ответ проверяется по форме 200 с полями query и records; пустой массив ведёт к повтору с умеренно увеличенным top_k. Без DIFY_API_KEY запрос не пройдёт аутентификацию. В составе также есть references/env.md, references/request-response.md и references/testing.md.
Какие задачи решает
- проверить запрос к Dify dataset retrieve API
- найти причину ошибки авторизации Dify
- настроить
retrieval_model.top_k - разобрать пустой или слабый результат поиска
- сверить форму запроса и ответа Dify
Примеры запросов агенту
- Проверь поиск по базе Dify для запроса «как оформить возврат» и покажи тело запроса.
- Разбери, почему
recordsпустой, и предложи, как изменитьretrieval_model.top_k. - Проверь интеграцию с Dify и найди ошибку в
DIFY_API_BASE_URLили заголовке авторизации.
Как установить dify-knowledge-base-search
1Через Skills CLI (Vercel)
npx skills add tiangong-ai/agent-skills --skill dify-knowledge-base-search -a claude-code2Вручную: положить файлы
~/.claude/skills/dify-knowledge-base-search/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/dify-knowledge-base-search/
1Через Skills CLI (Vercel)
npx skills add tiangong-ai/agent-skills --skill dify-knowledge-base-search -a codex2Вручную: положить файлы
.agents/skills/dify-knowledge-base-search/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tiangong-ai/agent-skills --skill dify-knowledge-base-search -a cursor2Вручную: положить файлы
.cursor/skills/dify-knowledge-base-search/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tiangong-ai/agent-skills dify-knowledge-base-search2Вручную: положить файлы
.github/skills/dify-knowledge-base-search/SKILL.md1Через Skills CLI (Vercel)
npx skills add tiangong-ai/agent-skills --skill dify-knowledge-base-search -a gemini-cli2Командой платформы
gemini skills install https://github.com/tiangong-ai/agent-skills --path dify-knowledge-base-searchВручную: положить файлы
.devin/skills/dify-knowledge-base-search/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add tiangong-ai/agent-skills --skill dify-knowledge-base-search -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о dify-knowledge-base-search
Как установить dify-knowledge-base-search в Claude Code?
Выполните npx skills add tiangong-ai/agent-skills --skill dify-knowledge-base-search -a claude-code. Скилл появится в ~/.claude/skills/dify-knowledge-base-search/SKILL.md.
Что делает dify-knowledge-base-search?
Он помогает отправлять запросы к Dify dataset retrieve API и проверять результат поиска по базе знаний. Скилл также разбирает параметры retrieval_model и типовые ошибки маршрута, авторизации и качества результатов.
Что нужно настроить до первого запроса?
Задайте DIFY_API_BASE_URL с суффиксом /v1, DIFY_DATASET_ID и DIFY_API_KEY. Запрос использует заголовок Authorization: Bearer $DIFY_API_KEY.
Исходный текст
SKILL.md · MIT
---
name: dify-knowledge-base-search
description: Dify dataset retrieve API for knowledge base chunk search/testing. Use when integrating or debugging Dify knowledge base retrieval requests, retrieval_model options, or response shaping.
---
# Dify Knowledge Base Search
## Prepare required inputs
- Provide `data` as JSON containing `query` and optional `retrieval_model.top_k`.
- Read these env vars:
- `DIFY_API_BASE_URL`: base API URL and include `/v1` (example: `https://api.dify.ai/v1`).
- `DIFY_DATASET_ID`: target dataset ID.
- `DIFY_API_KEY`: send as `Authorization: Bearer <DIFY_API_KEY>`.
## Send request
- Endpoint: `${DIFY_API_BASE_URL}/datasets/${DIFY_DATASET_ID}/retrieve`
- Headers:
- `Content-Type: application/json`
- `Authorization: Bearer <DIFY_API_KEY>`
- Use `assets/example-request.json` as the payload template.
```bash
curl -sS --location --request POST "$DIFY_API_BASE_URL/datasets/$DIFY_DATASET_ID/retrieve" \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DIFY_API_KEY" \
--data @assets/example-request.json
```
## Interpret response
- Request shape: `{ "query": string, "retrieval_model"?: { "top_k": number } }`
- Success shape: 200 with `{ query, records: [...] }`
- If `records` is empty, increase `retrieval_model.top_k` moderately and retry.
## Troubleshoot quickly
- If auth fails, verify `DIFY_API_KEY` and `Authorization` header format.
- If route fails, verify `DIFY_API_BASE_URL` includes `/v1`.
- If results are low quality, refine `query` and tune `top_k`.
## References
- `references/env.md`
- `references/request-response.md`
- `references/testing.md`
## Assets
- `assets/example-request.json`
© tiangong-ai · MIT · tiangong-ai/agent-skills