Създаване на работен процес (worker)
На тази страница
Ролята на работника (worker)
Работникът е Python процесът, който действително изпълнява Вашите работни потоци и дейности. Той се свързва с платформата на Mistral, слуша за чакащи задачи и ги изпълнява локално на Вашата машина или сървър. Този архитектурен детайл често изненадва начинаещите: Вашият код никога не напуска Вашата среда; само състоянието на оркестрацията се съхранява в Mistral.
Последствието е пряко и обяснява повечето проблеми от типа „нищо не се случва“, срещани в началото на даден проект: без стартиран работник, Вашите работни потоци не могат да се изпълнят. Можете да задействате изпълнение, но то просто ще изчака, докато се появи способен работник. Работникът е връзката между платформата за оркестрация на Mistral и Вашия локален код.
Създаване на минимален работник
Един функционален работник се събира в няколко реда. Примерът по-долу умишлено комбинира дейността, работния поток и логиката за стартиране в един файл, за да можете да го стартирате веднага:
import asyncio
import mistralai.workflows as workflows
# Import your workflows and activities
@workflows.activity()
async def dire_bonjour(nom: str) -> dict:
return {"message": f"Bonjour, {nom} !"}
@workflows.workflow.define(name="salutation_workflow")
class SalutationWorkflow:
@workflows.workflow.entrypoint
async def run(self, nom: str) -> dict:
resultat = await dire_bonjour(nom)
return resultat
# Start the worker
async def main() -> None:
await workflows.run_worker([SalutationWorkflow])
if __name__ == "__main__":
asyncio.run(main())
Ключовата функция е workflows.run_worker(). Тя приема списък с класове на работни потоци, които този работник може да изпълни – и само работни потоци. Дейностите се откриват чрез тях, така че не е необходимо да изброявате дейностите отделно.
Какво прави run_worker()
Когато извикате workflows.run_worker([MyWorkflow]), пет неща се случват последователно. Първо, работникът се удостоверява в платформата на Mistral, използвайки Вашия API ключ. След това той регистрира обявените работни потоци и дейности. Тази регистрация позволява на платформата да знае, че съществува изпълнител за идентификатора salutation_workflow. След това тя отваря постоянна връзка и чака задачи, оставайки умишлено в режим на изчакване, докато не бъде задействано изпълнение. Когато пристигне изпълнение, работникът стартира кода локално и резултатите се изпращат обратно към платформата за съхранение.
Работникът остава активен, докато Python процесът работи, поради което никога не връща контрола на Вашия терминал. Използвайте Ctrl+C, за да го спрете правилно.
Работник с множество работни потоци
Нищо не изисква един работник за всеки работен поток. Един единствен процес може да хоства множество работни потоци, дори когато те споделят дейности. Тук extraire_texte и analyser_sentiment обслужват и двете:
import asyncio
import mistralai.workflows as workflows
# --- Activities ---
@workflows.activity()
async def extraire_texte(url: str) -> dict:
async with httpx.AsyncClient() as client:
response = await client.get(url)
return {"texte": response.text}
@workflows.activity()
async def analyser_sentiment(texte: str) -> dict:
client = Mistral()
response = await client.chat.complete_async(
model="mistral-large-latest",
messages=[
{"role": "system", "content": "Analysez le sentiment : positif, négatif ou neutre."},
{"role": "user", "content": texte}
]
)
return {"sentiment": response.choices[0].message.content}
@workflows.activity()
async def envoyer_alerte(message: str) -> dict:
# Envoi vers Slack, email, etc.
return {"status": "envoyé"}
# --- Workflows ---
@workflows.workflow.define(name="analyse_document")
class DocumentAnalysis:
@workflows.workflow.entrypoint
async def run(self, url: str) -> dict:
extraction = await extraire_texte(url)
sentiment = await analyser_sentiment(extraction["texte"])
return sentiment
@workflows.workflow.define(name="surveillance_mentions")
class MentionMonitoring:
@workflows.workflow.entrypoint
async def run(self, url: str, seuil: str) -> dict:
extraction = await extraire_texte(url)
sentiment = await analyser_sentiment(extraction["texte"])
if sentiment["sentiment"] == "négatif":
await envoyer_alerte(f"Mention négative détectée : {url}")
return sentiment
# --- Worker ---
async def main() -> None:
await workflows.run_worker([
DocumentAnalysis,
MentionMonitoring,
])
if __name__ == "__main__":
asyncio.run(main())
Препоръчителна структура на файловете
Един единствен файл работи добре за обучение, но не и за реален проект. За продукционна среда разделете кода си на модули по тип:
mon-projet/
├── activities/
│ ├── __init__.py
│ ├── extraction.py # extraire_texte()
│ ├── analyse.py # analyser_sentiment()
│ └── notifications.py # envoyer_alerte()
├── workflows/
│ ├── __init__.py
│ ├── analyse_document.py
│ └── surveillance.py
└── worker.py # Single entry point
Файлът worker.py тогава съдържа само импорти и логика за стартиране, което го прави четима инвентаризация на това, което този процес може да изпълни:
import asyncio
import mistralai.workflows as workflows
from workflows.document_analysis import DocumentAnalysis
from workflows.monitoring import MentionMonitoring
async def main() -> None:
await workflows.run_worker([
DocumentAnalysis,
MentionMonitoring,
])
if __name__ == "__main__":
asyncio.run(main())
Стартиране на работника
uv run python worker.py
Работникът показва съобщение за връзка и остава активен, чакайки задачи. Трябва да видите нещо подобно:
Worker connected. Listening for tasks...
Докато не се появи този ред, не задействайте нищо. Първо проверете Вашия API ключ и мрежовата връзка.
Работник в продукционна среда
Работник, стартиран ръчно в терминал, изчезва след първото прекъсване на SSH връзката. Предайте го на мениджър на процеси – systemd, supervisor или pm2, – който автоматично ще го рестартира след срив или рестарт на системата:
# With pm2 (if Node.js is available)
pm2 start "uv run python worker.py" --name workflow-worker
# With systemd (create a .service file)
Това автоматично рестартиране върви добре с издръжливостта: стартираните работни потоци възобновяват работата си сами веднага щом новият процес се свърже. Що се отнася до секретите, никога не вграждайте API ключа директно във файла на работника, иначе той ще попадне във Вашето Git хранилище. SDK автоматично чете променливата на средата:
import os
# The SDK automatically reads MISTRAL_API_KEY
# No need to pass it explicitly
Накрая, помислете за регистрирането на събития (logging). Работникът излъчва съобщения чрез стандартния модул logging на Python. Една проста конфигурация при стартиране Ви осигурява следа от изпълнените дейности, което е ценно за разбиране на това какво се е изпълнявало по време на инцидент:
import logging
logging.basicConfig(level=logging.INFO)
Ключови изводи
- Работникът е процесът, който изпълнява Вашите работни потоци и дейности локално
workflows.run_worker([...])приема списък с класове на работни потоци за изпълнение- Един единствен работник може да изпълнява множество различни работни потоци
- Работникът остава активен и слуша за задачи, докато процесът работи
- В продукционна среда използвайте мениджър на процеси, за да поддържате работника активен
- API ключът се чете автоматично от
MISTRAL_API_KEY