Suiteáil an SDK Workflows
Ar an leathanach seo
Réamhriachtanais theicniúla
Tá ceithre rud ag teastáil uait sula scríobhann tú do chéad líne cód workflow. Ar dtús, teastaíonn Python 3.12 nó níos airde uait toisc go mbraitheann workflows ar ghnéithe async nua-aimseartha a tugadh isteach sa leagan seo. Teipfidh ar Python 3.11 ag am na hiompórtála, ní ag am rite, rud a fhágann go mbeidh an earráid láithreach ar a laghad. Sa dara háit, teastaíonn uv uait, an bainisteoir pacáistí a mholann Mistral do thionscadail Python. Déileálann sé le timthriallta fíorúla agus spleáchais araon. Faoi dheireadh, teastaíonn cuntas Mistral AI uait. Cruthaigh ceann ag console.mistral.ai mura bhfuil ceann agat cheana, agus giniúint eochair API sa rannán API Keys den chonsól.
Seiceáil do leagan Python
Tosaigh leis an mbacainn is coitianta: leagan an léirmhínitheora.
python --version
# Caithfidh sé Python 3.12.x nó níos airde a thaispeáint
Má tá do leagan níos ísle ná 3.12, nuashonraigh Python sula leanann tú ar aghaidh. Ar Ubuntu/Debian:
sudo apt update
sudo apt install python3.12 python3.12-venv
Ar macOS le Homebrew:
brew install [email protected]
Suiteáil uv
Mura bhfuil uv agat fós, suiteáil é. Athraíonn an t-ordú de réir an chórais:
# Linux / macOS
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Ansin fíoraigh go bhfuil an comhad dénártha i do PATH. Má fhilltear “not found” ar an ordú seo a leanas, oscail teirminéal nua. Athraíonn an suiteálaí do phróifíl blaoisce:
uv --version
Cruthaigh tionscadal
Cruthaigh tionscadal Python nua le uv:
mkdir mon-workflow-mistral
cd mon-workflow-mistral
uv init
Cruthaíonn sé seo comhad pyproject.toml agus struchtúr caighdeánach tionscadail. Liostaíonn an comhad pyproject.toml do chuid spleáchais agus ligeann sé do chomhghleacaí an timpeallacht chéanna go díreach a athchruthú.
Suiteáil an SDK Workflows
Tá dhá rogha suiteála agat, agus tá tábhacht leis an rogha. Mura bhfuil ag teastáil uait ach an t-inneall workflow—toisc go nglaonn do ghníomhaíochtaí ar APIanna inmheánacha, bunachar sonraí, nó seirbhísí tríú páirtí—is leor an leagan bunúsach:
uv add mistralai-workflows
Má theastaíonn uait gníomhairí marthanacha, glaonna uirlisí, agus aistrithe ilghníomhaire a úsáid go díreach i do chuid workflows, bain úsáid as an leagan le breiseáin:
uv add "mistralai-workflows[mistralai]"
Suiteálann an dara rogha SDK Mistral AI mar spleáchas agus cumasaíonn sé comhtháthuithe dúchasacha le samhlacha Mistral. Mura bhfuil tú cinnte ag tús tionscadail, tá an leagan bunúsach níos éadroime. Is féidir leat an breiseán a chur leis níos déanaí gan aon rud a bhriseadh.
Fíoraigh an tsuiteáil
Is fearr iompórtáil rathúil ná seiceáil láimhe fhada:
uv run python -c "import mistralai.workflows; print('Workflows SDK installed successfully!')"
Ba chóir duit an méid seo a leanas a fheiceáil:
Workflows SDK installed successfully!
Má fhaigheann tú ModuleNotFoundError, ná déan é a athshuiteáil láithreach bonn. Ar dtús, seiceáil go bhfuil tú sa fhillteán tionscadail áit ar rith tú uv add. Réitíonn an t-ordú uv run an timthriall fíorúil ón gcomhadlann reatha.
Cumraigh do eochair API
Déanann an SDK fíordheimhniú tríd an athróg timpeallachta MISTRAL_API_KEY. Léann sé seo go huathoibríoch; ní gá duit é a rith mar argóint. Socraigh é i do theirminéal:
# Linux / macOS
export MISTRAL_API_KEY="votre_clé_api_ici"
# Chun é a dhéanamh buan, cuir leis do ~/.bashrc nó ~/.zshrc é
echo export MISTRAL_API_KEY=votre_clé_api_ici >> ~/.bashrc
Oibríonn an modh seo d’fhorbairt áitiúil. Do thionscadail táirgeachta, is fearr comhad .env a lódáil trí python-dotenv nó bainisteoir rúnda do hardáin imlonnaithe. Cuirfear eochair i gcomhad .bashrc i gcúltaca nó i roinnt scáileáin faoi dheireadh.
Creatlach tapa (roghnach)
Soláthraíonn Mistral uirlis CLI a ghineann tionscadal workflow iomlán. Tá sé seo úsáideach chun an struchtúr expected a fheiceáil sula scríobhann tú do chuid féin:
uvx mistralai-workflows-cli setup
Táirgeann an t-ordú comhad workflow samplach, comhad gníomhaíochta, oibrí réidh le tosú, agus cumraíocht bhunúsach. I rith cúpla soicind, gheobhaidh tú tionscadal atá ag rith. Is féidir leat ansin é a thógáil apart píosa ar phíosa chun ról gach comhpháirte a thuiscint sula dtosaíonn tú ón mbun.
Struchtúr tionscadail molta
Do thionscadal workflow táirgeachta, molaimid an struchtúr seo:
mon-workflow-mistral/
├── pyproject.toml # Spleáchais (mistralai-workflows)
├── .env # Eochair API (ná déan commit air)
├── activities/
│ ├── __init__.py
│ ├── email.py # Gníomhaíochtaí a bhaineann le ríomhphost
│ └── data_processing.py # Gníomhaíochtaí próiseála sonraí
├── workflows/
│ ├── __init__.py
│ └── pipeline.py # Sainmhínithe workflow
└── worker.py # Pointe iontrála an oibrí
Déanann gníomhaíochtaí a scaradh ó workflows cothabháil agus tástáil aonaid níos fusa. Is feidhm async caighdeánach í gníomhaíocht is féidir leat a ghlaowh go díreach i dtástáil, cé go dteastaíonn an t-inneall chun workflow a rith. Tógann an deighilt seo cúig nóiméad ag tús tionscadail agus sábhálfaidh sí go leor ama duit nuair a bheidh níos mó ná deich ngníomhaíocht agat.
Príomhphointí
- Teastaíonn Python 3.12+ agus uv don SDK Workflows
- Dhá mhód suiteála: bunúsach (
mistralai-workflows) nó le comhtháthú AI (mistralai-workflows[mistralai]) - Cumraigh an eochair API tríd an athróg timpeallachta
MISTRAL_API_KEY - Gineann an t-ordú
uvx mistralai-workflows-cli setupsampla tionscadail iomlán - Scar do chuid gníomhaíochtaí, workflows, agus oibrí i gcomhaid ar leith chun inchothabháilteacht níos fearr a fháil