Mistral Le Chat 允许用户直接在其对话界面以及通过 Mistral AI Studio 构建、自定义和部署专用 AI 助手（即自定义智能体，custom agents）。自定义智能体无需用户在执行例行任务时反复粘贴提示词指令、重新上传参考文档或切换工具，而是将选定的 Mistral 基座模型、明确的系统规范、持久化文档库以及原生工具访问能力封装为一个可复用的助手。本指南详细介绍了如何使用 Le Chat 的智能体创建流程、构建定制化的系统指令、通过文档库连接参考文件以实现检索增强生成（RAG）、为智能体配备执行工具，以及通过直接提及（mention）在团队对话中部署它们。
Mistral 自定义智能体的核心架构
Mistral Le Chat 中的自定义智能体能够将通用大语言模型转变为面向特定角色的数字化协作者。通过将行为规则、专有知识和执行能力整合到单个持久化配置中，智能体消除了重复的初始设置，并减少了多轮会话中的提示词漂移（prompt drift）。
每个自定义智能体由四个相互关联的组件构成：
- 基座模型（Foundation Model）：决定推理能力、上下文窗口大小、延迟和运行成本的基础引擎。
- 系统指令（System Instructions）：规定语气、分析框架、输出格式及操作边界的行为准则和角色定义。
- 文档库（Document Libraries）：已上传知识文件（如企业政策手册、代码库文档或研究论文）的持久化集合，经索引后用于向量检索和扎实的事实引用。
- 工具连接器（Tool Connectors）：原生功能，例如实时网络搜索、沙箱化 Python 代码执行以及模型上下文协议（Model Context Protocol, MCP）集成，允许智能体获取实时信息或执行计算任务。
下表重点展示了核心 Mistral 模型与不同智能体使用场景的匹配关系：
| 模型 | 主要优势 | 推荐智能体使用场景 |
|---|---|---|
| Mistral Large | 先进的多步推理、细腻的语言理解、复杂的指令遵循 | 战略规划、法律文档分析、高管摘要综合、复杂客户支持 |
| Mistral Small | 高吞吐量、低延迟、高成本效益的处理能力 | 大规模分流处理、标准客户咨询解答、快速文本摘要 |
| Codestral | 针对 80 多种编程语言的专业代码生成、调试与重构 | 技术文档编写、代码审查、自动化测试生成、语法验证 |
| Pixtral | 对文本、图表、示意图和扫描图像的原生多模态理解 | 视觉报告信息提取、架构图分析、UI/UX 审查助手 |
在 Le Chat 中创建智能体的分步指南
在 Mistral Le Chat 中构建自定义智能体无需编写代码的技术经验。用户可以直接在 Web 工作区内完成助手的配置、测试和保存。
步骤 1：访问智能体工作区
- 使用您的组织或个人账户登录 Mistral Le Chat。
- 在左侧导航栏中，点击 Agents 标签页。
- 点击智能体目录右上角的 Create Agent 按钮。
- 选择从空白画布开始，或是选择预置的起步模板（例如编程助手、创意构思器或文档摘要器）作为基准。
步骤 2：定义智能体身份与核心元数据
- Name：指定一个清晰、独特的名称（例如
Financial-Auditor-Bot或Docs-Reviewer）。由于在聊天中是通过@符号调用智能体，请选择不含特殊符号的简明标识符。 - Description：提供智能体职责的简要概述。该描述会显示在团队的智能体目录中，帮助协作者了解何时调用该助手。
- Avatar：选择一个图标或上传视觉徽标，使智能体在多智能体聊天会话中具有辨识度。
步骤 3：选择模型引擎与参数
在模型配置设置下：
- 根据所需的分析深度，从下拉菜单中选择合适的 Mistral 模型。
- 如果通过 Mistral AI Studio 或高级设置进行配置，可调整 Temperature 参数。较低的数值（例如
0.1到0.3）会使智能体更具确定性和事实性，这对文档分析和代码审计至关重要。较高的数值（例如0.7到0.9）则有助于文案写作和头脑风暴所需的创意发散。
编写定制化系统指令
Instructions 字段充当系统提示词，定义了智能体如何理解查询、组织响应结构以及处理边缘情况。编写精确的指令可确保智能体专注于其目标，并遵循品牌或组织标准。
高性能指令的核心要素
为了最大化可靠性，建议将系统指令组织为明确的操作部分：
- 角色与人设（Role and Persona）：确立智能体的专业身份、资历水平和沟通风格（例如：“你是一名资深技术作家，专注于云计算基础设施的 API 文档编写”）。
- 任务目标（Task Objectives）：概述智能体必须交付的主要成果，如执行摘要、代码差异对比（diff）或分步排错工作流。
- 格式与输出规则（Formatting and Output Rules）：明确具体的输出结构，例如 CommonMark Markdown 表格、项目符号行动项或带有语言标签的代码片段。
- 负面约束与边界（Negative Constraints and Boundaries）：明确声明智能体不得执行的操作，包括拒绝超出范围的请求、避免猜测性断言或禁止使用原始 HTML。
- 引用指令（Citation Instructions）：指示智能体优先使用从附加知识文件中检索到的事实，并在提供文档中未包含相关信息时明确说明。
系统指令示例模板
以下是一个适用于企业政策助手的有效生产级系统指令示例：
Role & Purpose:
You are the Internal Compliance Assistant for Acme Corp. Your purpose is to help employees understand corporate IT security policies and data governance standards.
Operational Guidelines:
1. Always ground your explanations in the attached Acme Security Handbook documents.
2. When answering policy questions, quote the relevant policy section or document title.
3. If an employee asks a question that is not covered in the attached knowledge files, explicitly state: "This topic is not addressed in current company policy documentation. Please contact the IT Security team at security@acme.internal."
4. Never speculate or invent internal procedures.
Tone and Format:
- Professional, objective, and clear.
- Use bullet points for procedural steps.
- Avoid technical jargon unless explaining specific security protocols.
融入少样本示例（Few-Shot Examples）
在指令中加入少样本示例（即展示理想的用户输入与预期的模型输出配对）能够显著提高格式的一致性：
Example Interaction:
User: Can I use personal USB flash drives on company laptops?
Assistant: According to Section 4.2 of the IT Security Handbook ("Removable Storage Media"):
- Personal USB storage devices are strictly prohibited on all company-issued laptops.
- Data transfers must occur through approved enterprise cloud storage.
- Exceptions require written approval from the IT Security Director.
通过文档库连接知识文件
Mistral 自定义智能体最强大的功能之一，在于能够通过 Mistral 的**文档库（Document Libraries）**和原生检索增强生成（RAG），将回答建立在专有数据基础之上。
理解文档库
Mistral 没有将文件直接上传到可能导致上下文窗口杂乱的单个聊天会话中，而是将知识组织为持久化的 Document Libraries。一旦创建了文档库并填充了源材料，多个智能体就可以同时连接到该库。
支持的文件类型包括：
- PDF 文档（
.pdf） - 纯文本文件（
.txt） - Markdown 文件（
.md） - Word 文档（
.docx） - 代码仓库与技术规范
设置文档库
- 在 Le Chat 或 Mistral AI Studio 中，导航至 Libraries 部分。
- 点击 Create Library，输入具有描述性的标题（例如
Product-Specifications-2026），并添加可选的描述。 - 上传您的参考文档。Mistral 会自动启动文档解析、文本提取和向量嵌入处理。
- 监控文件处理状态：
Running：文档正在被解析、分块并编入向量数据库。Completed：文档已完成索引，可供检索查询。
为自定义智能体挂载文档库
- 在 Agents 编辑器中打开您的智能体。
- 导航至 Knowledge 或 Tools 配置面板。
- 启用 Document Library 工具。
- 选择您希望智能体检索的一个或多个特定文档库。
- 在系统指令中，通过指示模型来强化检索行为：“在回答有关专有流程或产品规范的问题之前，请先查阅已连接的 Document Library。”
事实依据与可验证引用
当智能体查询挂载的 Document Library 时，Mistral 的检索流水线会获取相关文本块并将其作为上下文依据提供。在响应中，智能体会生成可验证的引用（tool_reference 块），直接链接回源文档和页码。这种透明度使用户能够对照原始来源核实结论，从而消除 AI 幻觉。
团队访问权限与共享
在企业和组织工作区中，Document Libraries 支持细粒度的访问控制：
- Viewer：用户可以查询文档库并将其挂载到个人智能体，但无法添加或删除文档。
- Editor：团队成员可以上传新文件、更新现有文档并管理文档库元数据。
- Org Sharing：组织管理员可以在整个企业目录中共享文档库，确保所有团队访问相同且最新的文档。
为智能体配备原生工具
除了被动的文档检索外，Mistral 自定义智能体还可以配置主动执行工具：
- Web Search（
web_search）：使智能体能够实时查询公开网络。这对于追踪市场趋势、验证最新法规变化或收集当前行业新闻的智能体至关重要。 - Code Interpreter（
code_interpreter）：提供沙箱化的 Python 执行环境。智能体可以编写、运行和调试 Python 代码，以执行统计计算、清洗 CSV 数据集或生成数学模型。 - Image Generation：允许智能体根据用户请求生成上下文图表、营销原型图和插图。
- Connectors 与 Model Context Protocol（MCP）：对于开发者和企业团队，Mistral 支持注册外部 MCP 服务器和自定义函数调用，允许智能体查询内部数据库、触发 GitHub Pull Request 或更新 CRM 记录。
要激活工具，只需在智能体配置面板的 Tools 部分切换所需功能即可。
测试、验证与部署智能体
Mistral Le Chat 包含内置的迭代功能，可在将智能体共享给更广泛的团队之前验证其性能。
实时交互预览
在智能体配置界面的右侧，Le Chat 提供了一个实时的 Preview 面板：
- 输入典型的用户提示词，以验证智能体是否遵循系统指令。
- 提出需要附加文档知识的问题，以确认 RAG 连接器能够检索到相关段落并输出准确的引用。
- 测试边缘情况——例如偏离主题的问题或对抗性提示词——以确保边界防护规则稳固生效。
- 实时调整系统指令或添加补充说明规则。
自动保存
Mistral Le Chat 会实时自动保存对智能体元数据、系统提示词和工具配置的所有修改。无需手动点击保存按钮；更改会立即反映在随后的对话中。
在对话中调用自定义智能体
配置完成后，您的自定义智能体会出现在个人智能体抽屉和组织目录中：
- 通过
@提及直接调用：在任何新的或现有的 Le Chat 对话中，输入@后跟智能体名称（例如@ComplianceBot 如何申请软件许可证？）。该智能体便会接管当前对话轮次，应用其定制的指令和知识库。 - 专属智能体聊天：您可以直接在 Agents 标签页中点击智能体卡片并选择 Start Chat 来发起对话。
- 多智能体协作：在单个对话线程内，用户可以按顺序调用多个专业智能体（例如，要求
@DataAnalyst总结数据集，然后提示@Copywriter将分析结果转换为高管简报）。
智能体维护最佳实践
为了长期保持自定义智能体的准确性与实用价值，请遵循以下运营最佳实践：
- 保持文档库内容更新：定期审查并清理挂载库中过时的文档。当内部政策或产品功能发生变化时，上传更新后的文件并移除废弃版本，以防止产生相互冲突的答案。
- 迭代优化指令：审查用户交互并找出常见的失效模式。如果智能体频繁给出过于冗长的回答，请在系统指令中加入明确的长度限制。
- 区分通用角色与专业角色：不要构建试图同时处理营销、编程和合规事务的单一庞大智能体，而应针对特定工作流创建专注的专用智能体。
- 审计工具权限：仅启用智能体职责所严格必需的工具。例如，如果内部合规智能体的唯一事实来源必须是公司内部文档，则很少需要为其启用网络搜索。