Dify Knowledge Base Search

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 .

Send request

• Endpoint: ${DIFY_API_BASE_URL}/datasets/${DIFY_DATASET_ID}/retrieve
• Headers:
• Content-Type: application/json
• Authorization: Bearer
• Use assets/example-request.json as the payload template.

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tiangong-ai
• Source: tiangong-ai/agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.