Начало работы
Создание навыков
Монетизация
Что такое навык
Навык — это автоматизация, которую пользователи могут запускать через Polydo.
Анатомия навыка
Каждый навык состоит из нескольких компонентов:
┌────────────────────────────────────────────────┐
│ НАВЫК │
├────────────────────────────────────────────────┤
│ Метаданные │
│ ├─ Название │
│ ├─ Описание │
│ ├─ Категория │
│ ├─ Иконка │
│ └─ Цена │
├────────────────────────────────────────────────┤
│ Входные параметры (Input Schema) │
│ ├─ Название поля │
│ ├─ Тип данных │
│ ├─ Обязательность │
│ └─ Описание для пользователя │
├────────────────────────────────────────────────┤
│ Выходные параметры (Output Schema) │
│ ├─ Название поля │
│ ├─ Тип данных │
│ └─ Описание результата │
├────────────────────────────────────────────────┤
│ Webhook URL │
│ └─ URL вашего n8n workflow │
└────────────────────────────────────────────────┘
Жизненный цикл навыка
Статусы навыка
| Статус | Описание |
|---|---|
| Черновик | Навык в процессе создания. Не виден пользователям. |
| На модерации | Отправлен на проверку. Ожидает одобрения. |
| Активный | Опубликован в каталоге. Доступен для запуска. |
| Отклонён | Не прошёл модерацию. Требует доработки. |
| Приостановлен | Временно скрыт из каталога (по вашему желанию). |
| Архивирован | Снят с публикации. Не виден пользователям. |
Процесс публикации
Черновик → На модерации → Активный
│
└─→ Отклонён → Черновик (после доработки)
Типы данных
Входные параметры
| Тип | Описание | Пример значения |
|---|---|---|
string | Текстовая строка | "Привет, мир!" |
number | Число (целое или дробное) | 42, 3.14 |
boolean | Логическое значение | true, false |
file | Загружаемый файл | URL файла |
Выходные параметры
| Тип | Описание | Пример |
|---|---|---|
string | Текст | Результат обработки |
number | Число | Подсчитанное значение |
boolean | Да/Нет | Статус проверки |
file | Ссылка на файл | URL сгенерированного файла |
json | Структурированные данные | Массив или объект |
Примеры навыков
Пример 1: Генератор логотипов
Название: AI Генератор логотипов
Описание: Создаёт уникальные логотипы по текстовому описанию
Категория: AI и генерация
Цена: 50 токенов
Входные параметры:
- name: description
type: string
required: true
description: "Опишите желаемый логотип"
- name: style
type: string
required: false
description: "Стиль: минималистичный, винтажный, современный"
Выходные параметры:
- name: imageUrl
type: file
description: "URL сгенерированного логотипа"
- name: variations
type: json
description: "Дополнительные варианты"
Пример 2: SEO-анализатор
Название: SEO Анализ сайта
Описание: Полный SEO-аудит веб-страницы
Категория: Аналитика
Цена: 15 токенов
Входные параметры:
- name: url
type: string
required: true
description: "URL страницы для анализа"
Выходные параметры:
- name: score
type: number
description: "SEO-оценка от 0 до 100"
- name: issues
type: json
description: "Список найденных проблем"
- name: recommendations
type: json
description: "Рекомендации по улучшению"
Пример 3: Конвертер документов
Название: PDF в Word
Описание: Конвертирует PDF документы в редактируемый Word формат
Категория: Документы
Цена: 5 токенов
Входные параметры:
- name: file
type: file
required: true
description: "PDF файл для конвертации"
- name: preserveFormatting
type: boolean
required: false
description: "Сохранять форматирование"
Выходные параметры:
- name: documentUrl
type: file
description: "URL Word документа"
- name: pageCount
type: number
description: "Количество страниц"
Лучшие практики
Название и описание
✅ Хорошо:
- "SEO Анализ сайта — полный аудит за минуту"
- "Транскрибация аудио в текст с таймкодами"
❌ Плохо:
- "Мой крутой навык"
- "Делает что-то полезное"
Ценообразование
Рекомендации по установке цены:
| Сложность | Время выполнения | Рекомендуемая цена |
|---|---|---|
| Простой | < 5 сек | 1-5 токенов |
| Средний | 5-30 сек | 5-20 токенов |
| Сложный | 30 сек - 2 мин | 20-50 токенов |
| AI генерация | любое | 30-100 токенов |
Описание параметров
Пишите понятные описания для каждого параметра:
✅ Хорошо:
description: "URL сайта для анализа (например: https://example.com)"
❌ Плохо:
description: "url"
Ограничения
- Максимальное время выполнения: 5 минут
- Максимальный размер входного файла: 50 МБ
- Максимальный размер ответа: 10 МБ
- Входные параметры: до 10 полей
- Выходные параметры: до 10 полей
Модерация
Навыки проходят модерацию перед публикацией. Мы проверяем:
- Корректность работы (тестовый запуск)
- Адекватность описания
- Соответствие категории
- Отсутствие запрещённого контента
- Разумность цены
Обычно модерация занимает 1-2 рабочих дня.
Следующие шаги
- Webhook интеграция — техническая документация
- Обработка ошибок — как правильно обрабатывать ошибки
- Монетизация — как получать выплаты