Настройка DeepSeek Harness: плагины и AI-агенты

Гайд по установке и использованию DeepSeek Harness — фреймворка для создания AI-агентов с поддержкой плагинов. Разбираем архитектуру DSH, установку dsh-plugin и примеры интеграции с Cordis.

Средний

Алексей Кузнецов

Системный администратор20 октября 2026 г.2 мин чтения

pip install dsh dsh-plugin

mkdir -p ~/.dsh && echo 'export DEEPSEEK_API_KEY="ваш_ключ_здесь"' > ~/.dsh/config.env && source ~/.dsh/config.env

dsh-plugin init my_first_plugin

cat > my_first_plugin/__init__.py << 'EOF'
from dsh import Plugin

class MyFirstPlugin(Plugin):
    def execute(self, input_data: str) -> str:
        return f"Привет от плагина! Ты сказал: {input_data}"
EOF

echo 'plugins:
  - name: my_first_plugin
    path: ./my_first_plugin' > ~/.dsh/plugins.yaml

cat > agent.py << 'EOF'
from dsh import Agent
from my_first_plugin import MyFirstPlugin

agent = Agent(api_key="${DEEPSEEK_API_KEY}")
plugin = MyFirstPlugin()

user_input = input("Введите что-нибудь: ")
result = plugin.execute(user_input)
print(result)
EOF

python agent.py

pip install cordis && cordis connect --plugin my_first_plugin

Настройка DeepSeek Harness: плагины и AI-агенты

Гайд по установке и использованию DeepSeek Harness — фреймворка для создания AI-агентов с поддержкой плагинов. Разбираем архитектуру DSH, установку dsh-plugin и примеры интеграции с Cordis.

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

• Базовые навыки работы с терминалом Linux
• Установленный Python 3.10 или новее
• Аккаунт в DeepSeek с доступом к API
• Базовое понимание концепций AI-агентов

Шаг 1: Установка DeepSeek Harness через pip

Устанавливаем фреймворк DeepSeek Harness из официального репозитория. Используем менеджер пакетов pip для установки dsh и dsh-plugin.

pip install dsh dsh-plugin

Шаг 2: Настройка API-ключа DeepSeek

Создаём конфигурационный файл для хранения API-ключа. Ключ можно получить на странице управления аккаунтом DeepSeek.

mkdir -p ~/.dsh && echo 'export DEEPSEEK_API_KEY="ваш_ключ_здесь"' > ~/.dsh/config.env && source ~/.dsh/config.env

Шаг 3: Создание первого плагина для DSH

Создаём структуру плагина с использованием dsh-plugin. Плагин будет выполнять простую задачу — выводить приветствие.

dsh-plugin init my_first_plugin

Шаг 4: Реализация логики плагина

Открываем созданный файл плагина и реализуем функцию execute, которая будет вызываться агентом.

cat > my_first_plugin/__init__.py << 'EOF'
from dsh import Plugin

class MyFirstPlugin(Plugin):
    def execute(self, input_data: str) -> str:
        return f"Привет от плагина! Ты сказал: {input_data}"
EOF

Шаг 5: Регистрация плагина в конфигурации DSH

Добавляем наш плагин в конфигурационный файл DSH, чтобы агент мог его использовать.

echo 'plugins:
  - name: my_first_plugin
    path: ./my_first_plugin' > ~/.dsh/plugins.yaml

Шаг 6: Создание AI-агента с использованием плагина

Создаём скрипт агента, который использует наш плагин для обработки пользовательского ввода.

cat > agent.py << 'EOF'
from dsh import Agent
from my_first_plugin import MyFirstPlugin

agent = Agent(api_key="${DEEPSEEK_API_KEY}")
plugin = MyFirstPlugin()

user_input = input("Введите что-нибудь: ")
result = plugin.execute(user_input)
print(result)
EOF

Шаг 7: Запуск агента и тестирование плагина

Запускаем созданного агента и проверяем работу плагина. Вводим произвольный текст для проверки.

python agent.py

Шаг 8: Интеграция с Cordis (опционально)

Если вы используете Cordis — распределённую систему координации агентов, подключаем наш плагин к ней для масштабирования.

pip install cordis && cordis connect --plugin my_first_plugin