Skip to main content Home Creators jeremylongshore tons-of-skills-marketplace mistral-core-workflow-a
mistral-core-workflow-a Execute Mistral AI chat completions with streaming, multi-turn, and guardrails.
Use when implementing chat interfaces, building conversational AI,
or integrating Mistral for text generation.
Trigger with phrases like "mistral chat", "mistral completion",
"mistral streaming", "mistral conversation", "mistral guardrails".
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Copy promptShow prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace --skill mistral-core-workflow-aThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository
langchain-deploy-integration Deploy a LangChain 1.0 / LangGraph 1.0 app to Cloud Run, Vercel, or LangServe correctly — with timeouts sized for chain length, cold-start mitigation, SSE anti-buffering headers, and Secret Manager over .env. Use when prepping a first production deploy, debugging a stream that hangs behind a proxy, or diagnosing p99 latency spikes. Trigger with "langchain deploy", "langchain cloud run", "langchain vercel python", "langchain langserve", or "langchain docker".
name mistral-core-workflow-a description Execute Mistral AI chat completions with streaming, multi-turn, and guardrails.
Use when implementing chat interfaces, building conversational AI,
or integrating Mistral for text generation.
Trigger with phrases like "mistral chat", "mistral completion",
"mistral streaming", "mistral conversation", "mistral guardrails".
allowed-tools Read, Write, Edit, Bash(npm:*), Grep version 1.12.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","mistral","workflow"] compatibility Designed for Claude Code
Mistral AI Core Workflow A: Chat Completions
Overview
Production chat completion patterns for Mistral AI: multi-turn conversations, streaming responses, JSON mode structured output, guardrails/moderation, and model selection. Uses the @mistralai/mistralai SDK.
Prerequisites
Completed mistral-install-auth setup
MISTRAL_API_KEY environment variable set
Understanding of Mistral model tiers
Instructions
Step 1: Basic Chat Completion
import { Mistral } from '@mistralai/mistralai' ;
const client = new Mistral ({ apiKey : process.env .MISTRAL_API_KEY });
async function chat (userMessage : string ): Promise <string > {
const response = await client.chat .complete ({
model : 'mistral-small-latest' ,
messages : [
{ role : 'system' , content : 'You are a helpful assistant.' },
{ role : 'user' , content : userMessage },
],
});
return response.choices ?.[0 ]?.message ?.content ?? '' ;
}
Step 2: Multi-Turn Conversation Manager
{
: | | ;
: ;
}
{
: [] = [];
: ;
: ;
( ) {
. = ({ : process. . });
. = model;
. . ({ : , : systemPrompt });
}
( : ): < > {
. . ({ : , : userMessage });
response = . . . ({
: . ,
: . ,
});
reply = response. ?.[ ]?. ?. ?? ;
. . ({ : , : reply });
reply;
}
(maxTurns = ): {
system = . [ ];
recent = . . ( ). (-maxTurns * );
. = [system, ...recent];
}
}
conv = ( );
conv. ( );
conv. ( );
interface
Message
role
'system'
'user'
'assistant'
content
string
class
MistralConversation
private
messages
Message
private
client
Mistral
private
model
string
constructor
systemPrompt : string , model = 'mistral-small-latest'
this
client
new
Mistral
apiKey
env
MISTRAL_API_KEY
this
model
this
messages
push
role
'system'
content
async
send
userMessage
string
Promise
string
this
messages
push
role
'user'
content
const
await
this
client
chat
complete
model
this
model
messages
this
messages
const
choices
0
message
content
''
this
messages
push
role
'assistant'
content
return
trimHistory
20
void
const
this
messages
0
const
this
messages
slice
1
slice
2
this
messages
const
new
MistralConversation
'You are a coding tutor.'
await
send
'How do I reverse a list in Python?'
await
send
'What about in-place?'
Step 3: Streaming Responses async function streamChat (
messages : Message [],
onChunk : (text: string ) => void ,
): Promise <string > {
const stream = await client.chat .stream ({
model : 'mistral-small-latest' ,
messages,
});
let full = '' ;
for await (const event of stream) {
const text = event.data ?.choices ?.[0 ]?.delta ?.content ;
if (text) {
full += text;
onChunk (text);
}
}
return full;
}
app.post ('/chat/stream' , async (req, res) => {
res.setHeader ('Content-Type' , 'text/event-stream' );
res.setHeader ('Cache-Control' , 'no-cache' );
res.setHeader ('Connection' , 'keep-alive' );
const stream = await client.chat .stream ({
model : 'mistral-small-latest' ,
messages : req.body .messages ,
});
for await (const event of stream) {
const content = event.data ?.choices ?.[0 ]?.delta ?.content ;
if (content) {
res.write (`data: ${JSON .stringify({ content })} \n\n` );
}
}
res.write ('data: [DONE]\n\n' );
res.end ();
});
Step 4: JSON Mode and JSON Schema Mode
const jsonResponse = await client.chat .complete ({
model : 'mistral-small-latest' ,
messages : [
{ role : 'user' , content : 'List 3 countries with capitals as JSON array.' },
],
responseFormat : { type : 'json_object' },
});
const data = JSON .parse (jsonResponse.choices ?.[0 ]?.message ?.content ?? '{}' );
const schemaResponse = await client.chat .complete ({
model : 'mistral-small-latest' ,
messages : [
{ role : 'user' , content : 'Classify this ticket: "Login page crashes on mobile"' },
],
responseFormat : {
type : 'json_schema' ,
jsonSchema : {
name : 'ticket_classification' ,
schema : {
type : 'object' ,
properties : {
category : { type : 'string' , enum : ['bug' , 'feature' , 'question' ] },
severity : { type : 'string' , enum : ['low' , 'medium' , 'high' , 'critical' ] },
summary : { type : 'string' },
},
required : ['category' , 'severity' , 'summary' ],
},
},
},
});
Step 5: Guardrails and Moderation
const safeResponse = await client.chat .complete ({
model : 'mistral-small-latest' ,
messages : [{ role : 'user' , content : userInput }],
safePrompt : true ,
});
const moderation = await client.classifiers .moderate ({
model : 'mistral-moderation-latest' ,
inputs : [userInput],
});
const flagged = moderation.results [0 ].categories ;
if (Object .values (flagged).some (Boolean )) {
throw new Error ('Content flagged by moderation' );
}
Step 6: Model Selection Guide type UseCase = 'realtime' | 'analysis' | 'code' | 'vision' | 'embedding' ;
const MODEL_MAP : Record <UseCase , { model : string ; note : string }> = {
realtime : { model : 'mistral-small-latest' , note : '256k ctx, fast, $0.1/M in' },
analysis : { model : 'mistral-large-latest' , note : '256k ctx, reasoning, $0.5/M in' },
code : { model : 'codestral-latest' , note : '256k ctx, code + FIM, $0.3/M in' },
vision : { model : 'pixtral-large-latest' , note : '128k ctx, multimodal' },
embedding : { model : 'mistral-embed' , note : '1024-dim vectors, $0.1/M in' },
};
function selectModel (use : UseCase ): string {
return MODEL_MAP [use].model ;
}
Output
Chat completions with configurable parameters
Multi-turn conversation management with history trimming
Real-time streaming responses
JSON and JSON Schema structured output
Content moderation via guardrails
Error Handling Error Cause Solution 401 UnauthorizedInvalid API key Verify MISTRAL_API_KEY 429 Rate LimitedRPM or TPM exceeded Implement backoff (see mistral-rate-limits) 400 Bad RequestInvalid model or params Check model ID and message format Context exceeded Too many tokens Trim conversation history Empty JSON response Missing instruction Tell model to respond in JSON in prompt
Resources
Next Steps For embeddings and function calling, see mistral-core-workflow-b.