К основному содержанию
скилл CX Codex

dify-knowledge-base-search — скилл для Claude Code: поиск в Dify

Скилл dify-knowledge-base-search проверяет поиск чанков через Dify dataset retrieve API и помогает разбирать запросы, параметры retrieval_model и ответы.

MIT 114 установок ★ 11 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add tiangong-ai/agent-skills --skill dify-knowledge-base-search -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/dify-knowledge-base-search/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/dify-knowledge-base-search/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
Knowledge Base Manager daffy0208 Скилл Knowledge Base Manager для проектирования и ведения баз знаний на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Соединяет документный поиск (RAG) и граф сущностей в одном рабочем процессе. CX Codex +1 443установок Hivebook - The Knowledge Base for AI Agents hivebook Hivebook - The Knowledge Base for AI Agents — MCP-сервер для Claude Code, который даёт агенту общую базу знаний для поиска записей, чтения источников, проверки авторов и публикации правок. CX Codex +1 776установок cli-anything-dify-workflow HKUDS Скилл cli-anything-dify-workflow для Claude Code учит агента создавать, проверять и править YAML-воркфлоу Dify через командную обёртку. Ломается на импорте — чинится здесь. CX Codex +1 558установок Molio Knowledge Base zhuzhaoyun MCP-сервер Molio Knowledge Base даёт агенту доступ к локальной базе знаний Molio: поиск, чтение, просмотр и вопросы к материалам. Подходит для работы с накопленными заметками и документами. CX Codex +1 ★ 451звёзд репо okf-knowledge-base Inkeep Скилл okf-knowledge-base для Claude Code помогает создавать и проверять наборы знаний в формате OKF. Он включается при работе с OKF, предупреждениями плагина okf и выбором типов или ссылок. CX Codex +1 9 400установок taiwan-md-knowledge-base reason-machines Скилл taiwan-md-knowledge-base для Claude Code ведёт открытую базу знаний о Тайване на Astro v5: статьи на китайском и английском, граф связей на D3.js. Помогает писать и переводить материалы для такого проекта. CX Codex +1 1 300установок

Из того же набора5

Спонсоры проекта

Компании, которые помогают держать аналитику открытой