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將分析結果轉化為高階主管通訊）。
代理維護最佳實踐
為了長期保持自訂代理的準確性與實用價值，請遵循以下維運最佳實踐：
- 保持文件庫內容更新：定期審查並清理掛載庫中過時的文件。當內部政策或產品功能變更時，上傳更新後的檔案並移除過時版本，以避免產生相互衝突的答案。
- 反覆優化指令：審查使用者互動並找出常見的失效模式。若代理經常給予過於冗長的回覆，請在系統指令中加入明確的長度限制。
- 劃分廣泛角色與專業角色：與其建構一個試圖同時處理行銷、程式設計與合規事務的單一龐大代理，不如針對特定工作流程建立專注的專用代理。
- 稽核工具權限：僅啟用代理職責所嚴格必需的工具。例如，若內部合規代理的唯一事實來源必須是公司內部文件，則極少需要為其啟用網路搜尋。