技能介绍

要解决的问题

直接调用 Mistral AI 的 API，意味着你得自己保管 API Key、处理鉴权失败、并为每个接口维护请求格式。当 Agent 需要把 Mistral 的聊天补全、向量化、OCR、音频转写、微调等能力串进同一条工作流时，这套基础设施工作往往要重复做一遍。这个技能把 Mistral AI 封装成一组标准化动作，通过已连接的 OOMOL 账号直接调用。

核心能力与工作方式

技能通过 oo CLI 调用 mistral_ai connector，凭据由 OOMOL 在服务端注入，本地不接触原始 token。共暴露 54 个动作，覆盖：

对话与补全：create_chat_completion、create_fim_completion、create_agents_completion
多模态：create_audio_transcription（音频转写）、create_ocr（文档文字与版面识别）
向量化与审核：create_embeddings、create_moderation、create_chat_moderation
Agent 管理：create_agent、update_agent、list_agent_versions、get_agent_version
文件与知识库：upload_file、list_files、create_library、upload_library_document、get_document_text_content
会话管理：start_conversation、append_to_conversation、get_conversation_history、restart_conversation
批量与微调：list_batch_jobs、get_fine_tuning_jobs

典型调用分两步：先用 oo connector schema 拉取目标动作的权威输入/输出 schema，再构造匹配该 schema 的 JSON payload，通过 --data 传入执行；--data 支持内联 JSON 字符串或 @path/to/file.json，省略则发送 {}。响应统一为 { "data": ..., "meta": { "executionId": "..." } }，执行 ID 位于 meta.executionId。

适用边界与注意点

只读动作（get / list）可直接执行；创建、更新、发送类动作会改变 Mistral 侧状态，执行前应与用户确认确切的 payload 与预期效果。
删除类动作具有破坏性，必须先确认目标并取得明确同意。
正常情况下不要主动执行 oo auth login 或打开连接链接——凭据已由 OOMOL 托管，只有在命令实际报出鉴权或连接类错误时，才回退到一次性的首次设置流程。
会话类动作依赖 Mistral 侧的 session 状态，适合多轮对话编排，而不是无状态的单发请求。