Mistral Le Chat을 사용하면 사용자가 대화형 인터페이스 및 Mistral AI Studio 내에서 직접 특화된 AI 어시스턴트(커스텀 에이전트, custom agents)를 구축, 맞춤 설정 및 배포할 수 있습니다. 일상적인 작업마다 프롬프트 지침을 반복해서 붙여넣거나, 참조 문서를 다시 업로드하거나, 도구를 전환할 필요 없이, 커스텀 에이전트는 선택한 Mistral 기본 모델, 명시적인 시스템 가이드라인, 영구 문서 라이브러리 및 네이티브 도구 접근 권한을 재사용 가능한 하나의 어시스턴트로 패키징합니다. 본 가이드에서는 Le Chat의 에이전트 생성 워크플로를 탐색하고, 맞춤형 시스템 지침을 구성하며, 검색 증강 생성(RAG)을 위해 문서 라이브러리를 통해 참조 파일을 연결하고, 에이전트에 실행 도구를 장착하며, 직접 멘션을 사용하여 팀 대화 전반에 배포하는 방법을 자세히 설명합니다.
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에서 커스텀 에이전트를 구축하는 데는 기술적인 코딩 경험이 필요하지 않습니다. 사용자는 웹 워크스페이스 내에서 직접 어시스턴트를 구성, 테스트 및 저장할 수 있습니다.
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) 예시 통합
지침 내에 퓨샷 예시(이상적인 사용자 입력과 예상되는 모델 출력을 짝지어 보여주는 예시)를 추가하면 서식 일관성이 크게 향상됩니다:
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): 에이전트가 실시간으로 공개 웹을 쿼리할 수 있도록 합니다. 이는 시장 동향을 추적하거나, 최근 규제 변화를 확인하거나, 최신 업계 뉴스를 수집하는 에이전트에 필수적입니다. - 코드 인터프리터(
code_interpreter): 샌드박스 처리된 Python 실행 환경을 제공합니다. 에이전트는 Python 코드를 작성, 실행 및 디버그하여 통계 계산을 수행하거나, CSV 데이터 세트를 정제하거나, 수학 모델을 생성할 수 있습니다. - 이미지 생성(Image Generation): 사용자의 요청에 따라 에이전트가 상황에 맞는 다이어그램, 마케팅 모형 및 삽화를 생성할 수 있도록 지원합니다.
- 커넥터 및 모델 컨텍스트 프로토콜(MCP): 개발자와 기업 팀을 위해 Mistral은 외부 MCP 서버 등록 및 커스텀 함수 호출을 지원하여, 에이전트가 내부 데이터베이스를 쿼리하거나 GitHub 풀 리퀘스트를 트리거하거나 CRM 기록을 업데이트할 수 있도록 합니다.
도구를 활성화하려면 에이전트 구성 패널의 Tools 섹션에서 원하는 기능을 켜기만 하면 됩니다.
에이전트 테스트, 검증 및 배포
Mistral Le Chat에는 더 넓은 팀과 공유하기 전에 에이전트의 성능을 검증할 수 있는 반복 테스트 기능이 기본으로 내장되어 있습니다.
실시간 대화형 미리보기
에이전트 구성 인터페이스 우측에서 Le Chat은 실시간 Preview 패널을 제공합니다:
- 일반적인 사용자 프롬프트를 입력하여 에이전트가 시스템 지침을 준수하는지 확인합니다.
- 첨부된 문서의 지식이 필요한 질문을 던져 RAG 커넥터가 관련 구절을 검색하고 정확한 인용을 출력하는지 확인합니다.
- 주제를 벗어난 질문이나 적대적 프롬프트와 같은 예외 상황을 테스트하여 경계 보호 장치가 제대로 작동하는지 확인합니다.
- 시스템 지침을 실시간으로 조정하거나 명확한 규칙을 추가합니다.
자동 저장
Mistral Le Chat은 에이전트 메타데이터, 시스템 프롬프트 및 도구 구성에 대한 모든 수정 사항을 실시간으로 자동 저장합니다. 수동 저장 버튼을 누를 필요가 없으며 변경 사항은 이후 대화에 즉시 반영됩니다.
대화에서 커스텀 에이전트 호출
구성이 완료되면 커스텀 에이전트가 개인 에이전트 서랍 및 조직 카탈로그에 표시됩니다:
@멘션을 통한 직접 호출: 신규 또는 기존 Le Chat 대화에서@뒤에 에이전트 이름을 입력합니다(예:@ComplianceBot 소프트웨어 라이선스는 어떻게 신청하나요?). 에이전트가 해당 대화 턴의 제어권을 가져와 맞춤형 지침과 지식 베이스를 적용합니다.- 전용 에이전트 채팅: Agents 탭에서 에이전트 카드를 클릭하고 Start Chat을 선택하여 직접 대화를 시작할 수 있습니다.
- 다중 에이전트 협업: 단일 대화 스레드 내에서 사용자는 여러 전문 에이전트를 순차적으로 호출할 수 있습니다(예:
@DataAnalyst에게 데이터 세트 요약을 요청한 다음@Copywriter에게 그 결과를 임원용 뉴스레터로 변환하도록 요청).
에이전트 유지를 위한 모범 사례
커스텀 에이전트의 정확성과 유용성을 장기적으로 유지하려면 다음 운영 모범 사례를 따르세요:
- 문서 라이브러리 최신 상태 유지: 연결된 라이브러리에서 오래된 문서를 주기적으로 검토하고 정리합니다. 내부 정책이나 제품 기능이 변경되면 업데이트된 파일을 업로드하고 구버전을 제거하여 모순된 답변이 생성되지 않도록 하세요.
- 반복적인 지침 개선: 사용자 상호 작용을 검토하고 일반적인 오류 패턴을 파악합니다. 에이전트가 지나치게 장황한 응답을 자주 제공하는 경우 시스템 지침에 명시적인 길이 제한을 추가하세요.
- 광범위한 역할과 전문화된 역할 분리: 마케팅, 코딩, 규정 준수를 동시에 처리하려는 단일 모놀리식 에이전트를 구축하기보다는 특정 워크플로에 특화된 에이전트를 만드세요.
- 도구 권한 감사: 에이전트의 역할에 꼭 필요한 도구만 활성화합니다. 예를 들어 내부 규정 준수 에이전트의 유일한 정보 출처가 회사 내부 문서여야 한다면 웹 검색을 활성화할 필요가 거의 없습니다.