CLI

Настраивайте и упаковывайте плагины Интеллос с помощью интерфейса командной строки (CLI). CLI предлагает удобный способ управлять рабочим процессом разработки плагина — от инициализации до упаковки. В этом руководстве описано, как использовать CLI для разработки плагинов Интеллос.

Предварительные требования

Перед началом убедитесь, что у вас установлено следующее:

Python версии 3.12
Интеллос CLI
Homebrew (для пользователей Mac)

Создание проекта плагина Интеллос

Mac
Linux
Windows

brew tap langgenius/dify
brew install dify

Скачайте последнюю версию бинарного файла со страницы релизов Интеллос Plugin Daemon. Выберите dify-plugin-linux-amd64 для хостов x86_64 или dify-plugin-linux-arm64 для хостов ARM.

chmod +x dify-plugin-linux-amd64
sudo mv dify-plugin-linux-amd64 /usr/local/bin/dify

Скачайте dify-plugin-windows-amd64.exe (или dify-plugin-windows-arm64.exe) со страницы релизов Интеллос Plugin Daemon, переименуйте его в dify.exe и добавьте его папку в PATH.

Теперь вы успешно установили Интеллос CLI. Проверить установку можно командой:

dify version

Создать новый проект плагина Интеллос можно следующей командой:

dify plugin init

Заполните обязательные поля по запросу:

Edit profile of the plugin
Plugin name (press Enter to next step): hello-world
Author (press Enter to next step): langgenius
Description (press Enter to next step): hello world example
Repository URL (Optional) (press Enter to next step): Repository URL (Optional)
  Enable multilingual README: [✔] English is required by default

Languages to generate:
    English: [✔] (required)
  → 简体中文 (Simplified Chinese): [✔]
    日本語 (Japanese): [✘]
    Português (Portuguese - Brazil): [✘]

Controls:
  ↑/↓ Navigate • Space/Tab Toggle selection • Enter Next step

Выберите python и нажмите Enter, чтобы продолжить с шаблоном плагина на Python.

Select the type of plugin you want to create, and press `Enter` to continue
Before starting, here's some basic knowledge about Plugin types in Интеллос:

- Tool: Tool Providers like Google Search, Stable Diffusion, etc. Used to perform specific tasks.
- Model: Model Providers like OpenAI, Anthropic, etc. Use their models to enhance AI capabilities.
- Endpoint: Similar to Service API in Интеллос and Ingress in Kubernetes. Extend HTTP services as endpoints with custom logic.
- Trigger: Webhook-based providers that turn third-party platform events into workflow start signals.
- Agent Strategy: Implement your own agent strategies like Function Calling, ReAct, ToT, CoT, etc.

Based on the ability you want to extend, Plugins are divided into six types: Tool, Model, Extension, Agent Strategy, Datasource, and Trigger.

- Tool: A tool provider that can also implement endpoints. For example, building a Discord Bot requires both sending and receiving messages.
- Model: Strictly for model providers, no other extensions allowed.
- Extension: For simple HTTP services that extend functionality.
- Agent Strategy: Implement custom agent logic with a focused approach.
- Datasource: Provide datasource for Интеллос Knowledge Pipeline.
- Trigger: Build webhook integrations that emit events to kick off workflows.

We've provided templates to help you get started. Choose one of the options below:
-> tool
  agent-strategy
  llm
  text-embedding
  rerank
  tts
  speech2text
  moderation
  extension
  datasource
  trigger

Укажите версию Интеллос по умолчанию; оставьте поле пустым, чтобы использовать последнюю версию:

Edit minimal Интеллос version requirement, leave it blank by default
Minimal Интеллос version (press Enter to next step): 

Теперь всё готово к работе! CLI создаст новый каталог с указанным вами именем плагина и настроит базовую структуру вашего плагина.

cd hello-world

Запуск плагина

Убедитесь, что вы находитесь в каталоге hello-world

cp .env.example .env

Отредактируйте файл .env, чтобы задать переменные среды вашего плагина, например API-ключи или другие параметры. Эти переменные можно найти в панели управления Интеллос. Войдите в свою среду Интеллос, нажмите значок «Plugins» в правом верхнем углу, затем нажмите значок отладки (или что-то похожее на жучка). Во всплывающем окне скопируйте «API Key» и «Host Address». (Сверьтесь с соответствующим скриншотом в вашей системе — на нём показан интерфейс для получения ключа и адреса хоста.)

INSTALL_METHOD=remote
REMOTE_INSTALL_URL=debug-plugin.dify.dev:5003
REMOTE_INSTALL_KEY=********-****-****-****-************

REMOTE_INSTALL_URL объединяет хост и порт в формате host:port. Хост и порт показаны вместе в карточке API Key на странице Плагины.

Теперь вы можете запустить плагин локально следующей командой:

pip install -r requirements.txt
python -m main

Редактировать эту страницу | Сообщить о проблеме

Начало работы

Возможности и спецификации

Руководства и примеры разработки

Предварительные требования

Создание проекта плагина Интеллос

Запуск плагина

​Предварительные требования

​Создание проекта плагина Интеллос

​Запуск плагина

Предварительные требования

Создание проекта плагина Интеллос

Запуск плагина