Премини към основното съдържание
Български— Изберете език
Меню

Ограничения на платформата

Урок 10 от 14 Обновен 29 юли 2026 г. Напреднало
На тази страница
  1. Познавайте границите
  2. Две секунди между всяка дейност
  3. Два мегабайта на извикване
  4. Бюджетът за събития и обем
  5. Без вход/изход в работния поток
  6. Ключови изводи

Познавайте границите

Платформата Mistral Workflows е в етап на публичен преглед (към април 2026 г.). Както всяка оркестрационна система, тя налага технически ограничения, които трябва да разберете, за да проектирате надеждни работни потоци. Тези лимити не са просто бележки под линия в документацията; те се проявяват в продукционна среда, често в късен етап, под формата на грешки при сериализация или неочаквано прекратяване на работни потоци без предупреждение във Вашия код. Знанието за тях предварително променя начина, по който структурирате логиката си за обработка.

Таблицата по-долу обобщава основните ограничения и конкретното последствие от надхвърлянето на всяко от тях.

Ограничение Стойност Последствие при надхвърляне
Закъснение между дейностите 2 секунди Неизбежно забавяне между всяко извикване на дейност
Вход/изход на извикване 2 MB Грешка при сериализация, работният поток се проваля
Събития на изпълнение 51 200 Работният поток е принудително прекратен
Общ размер на изпълнение 50 MB Работният поток е принудително прекратен
Таймаут по подразбиране 1 час Работният поток се анулира (конфигурируемо до 7 дни)
Максимален таймаут 7 дни Работният поток се анулира автоматично
Вход/изход в работни потоци Забранено Грешка за недетерминираност по време на възпроизвеждане

Две секунди между всяка дейност

Платформата налага минимално забавяне от 2 секунди между извикванията на дейности. Това забавяне не е проблем от ранния етап на развитие; то е присъщо на оркестрационната архитектура, която запазва всяко събитие, преди да продължи. Това е цената на дълготрайността.

Въздействието е лесно за изчисляване и често изненадващо. Работен поток, свързващ десет последователни дейности, консумира поне двадесет секунди оркестрационно време, независимо колко дълго отнема самото изпълнение на дейностите. Ако всяка дейност се изпълнява за петдесет милисекунди, Вие сте проектирали задача за половин секунда, която отнема двадесет секунди, за да върне резултат.

Заобикалянето на проблема е да групирате операции, които не трябва да бъдат отделни, в една единствена дейност. Сравнете тези две версии на един и същи NLP конвейер.

# НЕОПТИМАЛНО: 3 дейности = 6 секунди оркестрационно забавяне
@workflows.workflow.define(name="pipeline_lent")
class SlowPipeline:
    @workflows.workflow.entrypoint
    async def run(self, text: str) -> dict:
        tokens = await tokenize(text)
        embeddings = await calculate_embeddings(tokens)
        clusters = await cluster(embeddings)
        return clusters

# ОПТИМИЗИРАНО: 1 дейност = 2 секунди оркестрационно забавяне
@workflows.activity()
async def complete_nlp_processing(text: str) -> dict:
    tokens = tokenize_local(text)
    embeddings = calculate_embeddings_local(tokens)
    clusters = cluster_local(embeddings)
    return {"clusters": clusters}

@workflows.workflow.define(name="pipeline_rapide")
class FastPipeline:
    @workflows.workflow.entrypoint
    async def run(self, text: str) -> dict:
        return await complete_nlp_processing(text)

Правилото за разделяне става просто: създавайте отделна дейност само ако имате нужда от гаранция за запазване на данните между две операции. Ако две операции могат да се провалят заедно, без да причинят проблеми – като локално токенизиране и изчисляване на вграждания, свързани в паметта – групирайте ги.

Два мегабайта на извикване

Всяко извикване на дейност е ограничено до 2 MB за вход и 2 MB за изход, въз основа на сериализираното JSON представяне на данните. PDF отчет, набор от изображения или голям CSV експорт лесно ще надхвърлят този лимит, което ще доведе до провал на работния поток с грешка при сериализация.

Решението се събира в едно изречение: предавайте референции, никога payloads (товари с данни). Дейността изтегля данните от външно хранилище, обработва ги локално (където е ограничена само от паметта на worker-а) и връща URL адреса на резултата.

@workflows.activity()
async def traiter_gros_fichier(fichier_url: str) -> dict:
    """Изтегляне, обработка и повторно качване на файла.
    Само URL адреси преминават през работния поток."""
    async with httpx.AsyncClient() as client:
        # Изтегляне от S3/GCS
        response = await client.get(fichier_url)
        contenu = response.content  # Може да бъде 100 MB

        # Обработка на файла
        resultat = traiter(contenu)

        # Качване на резултата
        await client.put(
            "https://storage.example.com/résultats/output.json",
            content=resultat
        )

    return {"url_resultat": "https://storage.example.com/résultats/output.json"}

Бюджетът за събития и обем

Всяко изпълнение е ограничено до 51 200 събития. Платформата генерира събитие за всяко стартиране на дейност, всяко приключване на дейност, всеки получен сигнал и всеки задействан таймер. На практика едно извикване на дейност струва около две до три събития, след като се включат метаданните, което поставя работен поток със сто дейности в диапазона от 250 до 300 събития. С други думи, лимитът позволява между петнадесет и двадесет хиляди извиквания на дейности на изпълнение: далеч повече от това, което повечето случаи на употреба изискват.

Ще достигнете този лимит само при масова обработка – например, итерация през петдесет хиляди документа в рамките на едно изпълнение. Шаблонът за продължаване, подробно описан в следващия урок, решава този проблем: работният поток обработва партида, след което стартира нов работен поток за следващата партида, нулирайки брояча на събитията.

Втората граница се отнася до обема: кумулативният размер на всички събития в едно изпълнение не трябва да надвишава 50 MB. Това се запълва по-бързо, ако Вашите дейности връщат богати обекти, тъй като всеки резултат се записва в дневника. Прилага се същият рефлекс – връщайте идентификатор, а не пълна структура, съхранявайте междинните резултати във външна услуга, обработвайте на страници на партиди – и това е достатъчно в огромното мнозинство от случаите.

Без вход/изход в работния поток

Последният ред от таблицата не е лимит за размер, а правило за проектиране, вече разгледано в контекста на детерминираността. Кодът на работния поток не трябва да съдържа операции за вход/изход: никакви мрежови повиквания (httpx, aiohttp, requests), никакво четене или запис на файлове (open, aiofiles), никакъв достъп до бази данни и никакво четене на променливи на средата за управление на разклоненията. Всички тези операции живеят в дейности, чиито резултати се регистрират и следователно могат да бъдат възпроизведени идентично.

Ключови изводи

  • 2 секунди минимално забавяне между всяка дейност – групирайте свързани операции
  • 2 MB максимум за вход/изход на дейност – използвайте външно хранилище за големи данни
  • 51 200 събития и 50 MB максимум на изпълнение – използвайте шаблона за продължаване за много дълги работни потоци
  • Без вход/изход в кода на работния поток – всичко отива в дейностите
  • Тези ограничения произтичат от основната архитектура на Temporal и статуса на Публичен преглед