# dify-plugin-knowledge-tools

**Repository Path**: azhengzz/dify-plugin-knowledge-tools

## Basic Information

- **Project Name**: dify-plugin-knowledge-tools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-12
- **Last Updated**: 2025-11-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## knowledge-tools

**Author:** zhangzheng
**Version:** 0.0.2
**Type:** tool

### Description

Knowledge Tools is a Dify plugin that provides a comprehensive set of tools for interacting with Dify Knowledge API. This plugin allows users to manage and retrieve information from knowledge bases, including listing knowledge bases, retrieving document lists, getting knowledge base details, and searching for relevant content blocks.

### Features

The plugin includes the following tools:

1. **Get Knowledge Base List** - Retrieves a paginated list of all knowledge bases with optional filtering
2. **Get Knowledge Dataset Detail** - Retrieves detailed information about a specific knowledge base by its ID
3. **Get Knowledge Document List** - Retrieves a paginated list of all documents within a specified knowledge base
4. **Retrieve Knowledge Blocks** - Retrieves the most relevant content blocks (segments) from a knowledge base based on a search query

### Prerequisites

- Python 3.12
- Dify plugin SDK (dify_plugin>=0.4.0,<0.7.0)

### Installation

1. Clone the repository
2. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

### Configuration

The plugin requires the following credentials:
- Dify Knowledge API Base URL (e.g., "https://api.dify.ai/v1")
- Dify Knowledge API Key (obtained from Dify Console > Knowledge > API Access > API Key)

### Usage

After installation and configuration, the plugin can be used within the Dify platform to interact with knowledge bases through the provided tools.

### Development

For development and debugging:
1. Copy `.env.example` to `.env` and configure:
   ```
   INSTALL_METHOD=remote
   REMOTE_INSTALL_URL=debug.dify.ai:5003
   REMOTE_INSTALL_KEY=your-debug-key
   ```
2. Run the plugin:
   ```bash
   python -m main
   ```
3. Refresh the Dify instance to see the plugin (marked as "debugging plugin")