Automatiseringen: Mistral AI workflow acties

AI is het handigst als het onderdeel is van je automatisering, en niet als een losse handmatige stap. Met de Mistral AI-integratie kunnen je workflows Mistral-taalmodellen aanroepen, embeddings genereren voor semantisch zoeken, en afbeeldingen analyseren. Je gebruikt hiervoor je eigen Mistral API key, en de response is daarna beschikbaar als workflow-variabele voor een volgende stap.

Dat betekent dat workflows bijvoorbeeld:

een klant kunnen antwoorden in de taal van de klant,
de beste match kunnen zoeken in een kennisbank,
of gestructureerde data kunnen ophalen uit een geüploade bon,

zonder dat je een contact hoeft door te sturen naar een tool van een derde partij.

Over de integratie

Mistral AI is een Franse AI-lab dat open-weight en frontier taalmodellen bouwt. De integratie bevat drie acties:

Create Chat Completion — tekst genereren met de Mistral Large, Medium, Small, Ministral en Magistral families.
Create Embeddings — zet tekst om in een 1024-dimension vector voor semantisch zoeken, classificatie of clustering.
Analyze Image (Vision) — stuur een afbeelding plus prompt naar een vision-geschikt Mistral-model en ontvang een gestructureerd antwoord in natuurlijke taal.

Alle drie de acties zijn premium actions.

Belangrijkste voordelen van Mistral AI in workflows

Sterke meertalige dekking — Mistral-modellen zijn native getraind op 40+ talen, met extra sterke prestaties in Europese talen. Dit is handig als je contactenlijst niet vooral Engelstalig is.
Afbeeldingen direct begrijpen — bonnen, ID’s, grafieken, screenshots en productfoto’s kun je binnen een workflow laten uitlezen, zonder een losse OCR-leverancier te integreren.
Reasoning-modellen wanneer je ze nodig hebt — voor multi-step logica kun je Magistral kiezen, zodat het model de stappen kan doorlopen voordat het antwoord wordt gegeven.

Mistral AI instellen

Voordat een Mistral AI-actie kan draaien, moet je de integratie eerst koppelen. Met die koppeling kunnen je workflows Mistral veilig aanroepen met jouw API key.

Koppelen via de Workflow Builder (aanbevolen)

Open Automation → Workflows en kies (of maak) een workflow.
Klik in de builder op Add om een nieuwe stap toe te voegen.
Open het tabblad Apps en zoek naar Mistral AI.
Kies een Mistral AI-actie: Create Chat Completion, Create Embeddings, of Analyze Image.
Klik op Connect Now op de actiekaart.
Plak je Mistral API key. Om er een te maken: log in op console.mistral.ai, open API Keys, klik op Create new key, geef de key een herkenbare naam, en kopieer de key.
Klik op Save om de koppeling af te ronden.

Koppelen via Settings (alternatieve route)

Ga naar Settings → Integrations.
Zoek Mistral AI in de lijst met integraties en klik op Connect.
Plak je Mistral API key en klik op Save.

Lijst met acties

Actie	Doel
Create Chat Completion	Stuur een prompt (en optioneel een system prompt) naar een Mistral-taalmodel en ontvang een gegenereerde tekstresponse.
Create Embeddings	Zet inputtekst om in een 1024-dimension vector voor semantisch zoeken, RAG, classificatie of clustering.
Analyze Image (Vision)	Stuur een image URL en een prompt naar een vision-geschikt Mistral-model en ontvang een antwoord in natuurlijke taal over de afbeelding.

Lijst met triggers

Er zijn op dit moment geen Mistral AI-triggers. Mistral AI is in deze versie alleen beschikbaar als actie. Dat betekent dat workflows Mistral-modellen vanuit elke stap kunnen aanroepen, maar niet gestart kunnen worden door een event vanuit Mistral. Trigger-ondersteuning kan in een latere release worden toegevoegd.

Voorbeeld: een actie instellen (Create Chat Completion)

In deze walkthrough maak je een geautomatiseerd meertalig antwoord. De workflow luistert naar een inkomend bericht, vraagt Mistral om een vriendelijke reactie te schrijven in de taal van het contact, en verstuurt die daarna terug via e-mail.

Stap 1: voeg de actie toe

Open of maak een workflow.
Klik op Add om een stap toe te voegen.
Ga in het rechterpaneel naar het tabblad Apps.
Zoek Mistral AI en klik om de acties uit te klappen.
Kies Create Chat Completion.

Stap 2: configureer de actie

In het configuratiepaneel zie je de standaard velden voor prompt en model:

Action Name — geef de stap een duidelijke naam, zoals ‘Draft Multilingual Reply’.
System Prompt (optional) — leg de persona en regels vast. Voorbeeld: ‘You are a friendly support agent. Always reply in the contact’s preferred language. Keep responses under 80 words.’
Prompt (required) — zet de instructie erin, met workflow-variabelen. Voorbeeld: ‘Reply to this message from contact.first_name: trigger.message_body. Their preferred language is contact.language.’
Model (required) — kies een Mistral-model. Gebruik Mistral Large voor de hoogste kwaliteit bij meertalige output. Kies Mistral Small of Ministral voor snellere en goedkopere runs.
Optional tuning — pas bijvoorbeeld temperature en max tokens aan voor creativiteit en lengte, afhankelijk van wat de actie ondersteunt.

Stap 3: opslaan en de output gebruiken

Klik op Save Action. De gegenereerde response wordt beschikbaar als workflow output-variabele. Je kunt die variabele daarna gebruiken in een Send Email-stap, wegschrijven naar een custom field, of gebruiken in een conditional.

Voorbeeld: Analyze Image (Vision) instellen

In dit voorbeeld haal je gestructureerde data uit een geüploade bon en schrijf je die weg naar het contactrecord.

Voeg een stap toe en kies onder Mistral AI de actie Analyze Image (Vision).
Zet Action Name op ‘Parse Receipt Image’.
In Image URL voeg je de workflow-variabele in die de geüploade afbeelding bevat, bijvoorbeeld de file URL uit een Form Submission-stap of een Media Storage entry.
Zet System Prompt op: ‘You are a receipt parser. Always respond with valid JSON only.’
Zet Prompt op: ‘Extract vendor_name, total_amount, currency and purchase_date from this receipt. Return a JSON object with exactly those four keys.’
Kies een vision-geschikt model uit de dropdown.
Draai Test Action met een voorbeeld-URL om te controleren of de JSON-structuur klopt, en sla daarna op.
In vervolgstappen parse je de JSON-output en gebruik je de waarden om contact custom fields bij te werken, een Opportunity aan te maken, of een interne Slack-notificatie te sturen.

Veelgestelde vragen

V: Wat is Mistral AI?

Antwoord: Mistral AI is een AI-lab dat open-weight en frontier taal- en visionmodellen ontwikkelt. De integratie geeft workflows directe, gecontroleerde toegang tot die modellen met jouw eigen API key.

Antwoord: Modellen uit de Mistral Large, Medium, Small, Ministral en Magistral families. De lijst wordt periodiek bijgewerkt wanneer Mistral oudere versies uitfaseert en nieuwe modellen uitbrengt.

V: Heb ik een apart Mistral-account nodig?

Antwoord: Ja. Je gebruikt je eigen API key van console.mistral.ai. Inference wordt door Mistral zelf gefactureerd op basis van je account tier en het gekozen model.

V: Zijn Mistral AI-acties premium workflow actions?

Antwoord: Ja. Alle drie de acties gebruiken premium action credits volgens het standaard automation-tarief, naast de kosten die Mistral rekent voor gebruik.

V: Kan ik workflow-variabelen gebruiken in prompts?

Antwoord: Ja. Zowel de System Prompt als de Prompt ondersteunen inline variabelen, zoals contactvelden, custom fields, trigger payload values, en outputs van eerdere workflowstappen.

V: Waar wordt de AI-gegenereerde response opgeslagen?

Antwoord: De response wordt beschikbaar als workflow output-variabele op de actie. Je kunt die gebruiken in berichten, wegschrijven naar custom fields, of doorgeven aan downstream steps. Standaard wordt het niet als losse record opgeslagen.

V: Wat gebeurt er als Mistral een error teruggeeft of een time-out heeft?

Antwoord: De actie toont de error in de workflow execution log. Daarna gaat de workflow verder volgens de ingestelde branching. Test de actie altijd voordat je publiceert, en voeg een fallback branch toe als betrouwbaarheid belangrijk is.

V: Kan ik de gegenereerde response gebruiken in SMS- of e-mailberichten?

Antwoord: Ja. De output-variabele kun je invoegen in Send SMS, Send Email, interne notificaties, en andere messaging actions.

V: Wat is de dimensie van de embedding-output?

Antwoord: 1024 dimensies. De vector is direct bruikbaar met veelgebruikte vector databases. Je kunt de vector bijvoorbeeld doorgeven aan een webhook action die schrijft naar je vector store.

V: Welke image formats accepteert Analyze Image?

Antwoord: Standaard PNG en JPEG via een directe URL, inclusief afbeeldingen in Media Storage die je benadert via file URL. Afbeeldingen worden op native resolutie verwerkt door het onderliggende visionmodel.

V: Zijn deze acties klaar voor productie?

Antwoord: Alle drie de acties zijn uitgebracht als Beta. Ze zijn veilig te gebruiken in live workflows, maar houd rekening met doorlopende UX-updates, zoals extra modellen die aan de dropdown worden toegevoegd, terwijl de integratie verder wordt ontwikkeld.