Общий агент ErisPulse-QvQChat

ErisPulse-QvQChat — это модуль общего агента, построенный вокруг цикла инструментов: получение и отправка сообщений, вызов сервисов экосистемных модулей, написание и выполнение кода, управление компьютером, генерация изображений и голоса, управление расписанием задач и долгосрочной памятью — всё это выполняется с помощью единой протокола инструментов.

epsdk install ErisPulse-QvQChat

Основные возможности

Модульное расширение

Любой модуль ErisPulse, объявляющий services, автоматически становится инструментом QvQChat без необходимости специального интерфейса:

from ErisPulse.Core.Bases import BaseModule, ModuleMeta

class Main(BaseModule):
    @staticmethod
    def get_meta() -> ModuleMeta:
        return ModuleMeta(name="Draw", services=[
            {"name": "draw", "description": "Генерирует изображение по описанию и возвращает URL изображения"},
        ])

    async def draw(self, prompt: str, size: str = "1024x1024"):
        return {"image_url": "https://..."}

Подпись метода автоматически сопоставляется с определением параметров JSON Schema инструмента, а первая строка docstring используется как описание параметра.

Глубокая интеграция (необязательно)

Модуль может дополнительно реализовать любую из следующих служб, каждая из которых необязательна — один модуль может быть предназначен только для расширения персонажа, а может только внедрять системные подсказки:

qvq_prompts() → Внедрение системных подсказок

Возвращает list[str] или list[{"text": str, "priority": int}], объединяя подсказки по возрастанию priority.

async def qvq_prompts(self):
    return [
        {"text": "Отправьте пользователю изображение с помощью send_message после рисования.", "priority": 10},
        {"text": "Поддерживаемые стили: аниме, реализм, акварель, пиксель.", "priority": 20},
    ]

qvq_personas() → Регистрация предустановленных персонажей

Возвращает список персонажей, id автоматически добавляется префикс ext.<имя_модуля>., модуль при отключении автоматически очищается. Подходит для модулей, специально предоставляющих расширение персонажей (например, эмоциональное сопровождение, переводчик, рецензент кода и т.д.).

async def qvq_personas(self):
    return [
        {"id": "companion", "name": "Теплый парень", "system": "Ты — тёплый и внимательный собеседник..."},
        {"id": "coder", "name": "Код-наставник", "system": "...", "tools": ["read_file", "run_python"]},
    ]

Параметр tools необязательно может ограничивать набор доступных инструментов для этого персонажа.

qvq_schemas() → Явное определение схемы параметров

Возвращает dict[имя_службы, JSON Schema], перезаписывая вывод из сигнатуры метода. Используется, когда параметры сложные или требуется строгая проверка.

async def qvq_schemas(self):
    return {
        "draw": {
            "type": "object",
            "properties": {
                "prompt": {"type": "string", "description": "Описание изображения"},
                "size": {"type": "string", "enum": ["512x512", "1024x1024"]},
            },
            "required": ["prompt"],
        },
    }

Время обновления

Время обновления глубоких интеграционных служб: запуск, установка и удаление модуля, ручное обновление на странице Dashboard «Инструменты».

Подписка на события

QvQChat транслирует два события жизненного цикла:

async def setup(self):
    sdk.lifecycle.on("qvq.message", self.on_message)

Вызов как сервис

Интерфейс

Доступ к интерфейсу осуществляется по отдельному адресу /QvQChat/view или встраивается в боковую панель панели управления.