The Mistral AI steps run on your company's own Mistral key. Ask a model answers a prompt with text or named fields, as the other AI steps do. Create embeddings turns text into vectors for search and matching. Read a document (OCR) reads a PDF or image — a scanned invoice, a signed delivery note — into text, page by page.
Who can do this
Workspace Admins and Editors, on every plan.
Before you start
A Mistral AI connection in Connections — see Connect Mistral AI.
Steps
Ask a model:
- Select + where the question should be asked. In the step picker, open AI, then Mistral AI, and select Ask a model.
- In Connection, choose the connection with your key.
- Optional: in Model, choose a model. The list is read from Mistral with your key; left empty, the step uses Mistral's current general model, set in Bizomate. To use a model the list does not show, select Use a value and type its name.
- Optional: in Instructions, say who the model is and how to answer — You sort customer messages for Northwind Logistics. Answer with one word only.
- In Prompt, ask the question, with the item's values in
{{ }}— Is this a quote request, a complaint or other? {{ $json.text }} - Under Give me back, choose Fields (the default) — named answers later steps can use one by one — or Text.
- For Fields, add a row per answer: the name, and what goes in it — category — quote | complaint | other.
- Select Run this step, then check Output. Pin it while you build the steps after — see Pin a step's output.
Create embeddings:
- In the step picker, under Mistral AI, select Create embeddings, and choose the Connection.
- In Model, keep Mistral's embedding model, or choose another from the list.
- In Text, give the text —
{{ $json.description }}— or a list of texts from an earlier step. Each text gets its own vector, in the order given. - Select Run this step.
Read a document (OCR):
- In the step picker, under Mistral AI, select Read a document (OCR), and choose the Connection.
- Under File, select Add a file and drag in the PDF or image from an earlier step — a form's upload, or an email attachment. See Pass files between steps.
- Optional: in Pages, the pages to read — 1-3 — when you need only some of a long document.
- Select Run this step. Each page comes back as text, with headings and tables kept as Markdown.
Output
| Step | Keys |
|---|---|
| Ask a model, Fields | each field by its name — {{ steps.sort_the_message.category }} — and usage |
| Ask a model, Text | text and usage |
| Create embeddings | count, dimensions, embeddings (one list of numbers per text, in order), first (the first one), usage |
| Read a document (OCR) | text (every page together), pages (each with index and markdown), pageCount, usage |
usage holds model, tokensIn, tokensOut and seconds — for OCR, pages in place of tokens. Output shows them as the usage strip. Every test run of this step spends them again — which is what Pin is for.
Good to know
- Each item is a separate call, and a separate cost. Twenty items, twenty calls.
- Mistral bills your account, not Bizomate. OCR is charged by the page.
- Files pass between steps up to 250 MB; Mistral may refuse a very large document — read fewer Pages at a time.
- Fields are always all filled. The model must give every field named; a field with
|choices gets one of them. - For a busy account, set If this step fails to try again — see Make a step try again when it fails.
If something goes wrong
| What the run says | Why | What to do |
|---|---|---|
| Mistral AI refused the API key. Replace it on Connections. | The key is wrong, revoked or its workspace has no plan. | Replace the key on Connections. |
| Mistral AI says too many requests, or the account is out of credit. Set this step to try again, or check the account. | A rate limit, or the plan's limit is used up. | Check the plan in Mistral; set the step to try again. |
| Mistral AI answered 400: … | Mistral refused the request — an unknown model, say. It is not tried again. | Read Mistral's reason; check the model and prompt. |
| Mistral AI did not give back the fields asked for. Try again, or make the instructions plainer. | The answer was not in the fields asked for. | Make Instructions plainer, or the fields fewer. |
| File is empty. Choose a file from an earlier step. | File has no file. | Drag in a file from Data from earlier steps. |
| Attachment 1 is not a file when the step ran — … may not have brought one. | The earlier step brought no file in that run. | Check the earlier step gives a file. |
| *Mistral AI refused: … * (Create embeddings, Read a document) | Mistral refused the request — a file it cannot read, an unknown model, or a key it does not accept. | Read Mistral's reason; for the key, replace it on Connections. |
| Pages “…” is not a page or a range, such as 1-3. | Pages holds something else. | Write pages as 1-3, 7. |
| Could not reach Mistral AI: … / Mistral AI did not answer in time. | Mistral did not answer. | Try again. |