Mistral

Mistral

Mistral AI의 모델을 Docker Agent에서 사용하는 방법을 설명해요. OpenAI 호환 API로 강력한 언어 모델을 쓸 수 있어요.

출처: 문서

본문

Mistral AI는 OpenAI 호환 API를 통해 강력한 언어 모델을 제공해요. Docker Agent에는 Mistral을 기본 제공 alias 프로바이더로 지원하고 있어요.

설정

  • Mistral Console에서 API 키를 받으세요.
export MISTRAL_API_KEY=your-api-key

사용법

인라인 문법

Mistral을 쓰는 가장 간단한 방법:

agents:
  root:
    model: mistral/mistral-large-latest
    description: Assistant using Mistral
    instruction: You are a helpful assistant.

네임드 모델 (Named Model)

파라미터를 더 세밀하게 제어하려면:

models:
  mistral:
    provider: mistral
    model: mistral-large-latest
    temperature: 0.7
    max_tokens: 8192

agents:
  root:
    model: mistral
    description: Assistant using Mistral
    instruction: You are a helpful assistant.

사용 가능한 모델

모델 설명 컨텍스트
mistral-large-latest 가장 강력한 Mistral 모델 128K
mistral-medium-latest 성능과 비용의 균형 128K
mistral-small-latest 빠르고 비용 효율적(기본값) 128K
codestral-latest 코드 생성에 최적화 32K
open-mistral-nemo 오픈웨이트 모델 128K
ministral-8b-latest 컴팩트한 8B 파라미터 모델 128K
ministral-3b-latest 가장 작은 Mistral 모델 128K

최신 모델은 Mistral Models 문서에서 확인하세요.

자동 감지

구성을 지정하지 않고 docker agent run을 실행했고 프로젝트 레벨 docker-agent.yaml, docker-agent.yml, docker-agent.hcl이 없으면, Docker Agent가 사용 가능한 프로바이더를 자동으로 감지해요. MISTRAL_API_KEY가 설정되어 있고 더 높은 우선순위의 프로바이더(OpenAI, Anthropic, Google)가 없다면, Mistral이 mistral-small-latest를 기본 모델로 사용돼요.

확장 생각 (Extended Thinking)

Docker Agent의 thinking_budget 필드는 Mistral 모델에 적용되지 않아요. 기반 OpenAI 호환 클라이언트는 OpenAI 추론 모델 이름(o-시리즈, gpt-5)에만 reasoning_effort를 보내기 때문이에요. Mistral 모델에 thinking_budget을 설정하면 구성 검증은 통과하지만 요청에는 영향이 없어요.

Mistral 추론 모델(예: magistral)은 설정 없이 스스로 추론해요. 비추론 모델에는 think 도구를 대신 사용하세요.

동작 방식

Mistral은 Docker Agent의 기본 제공 alias로 구현돼 있어요:

즉 Mistral은 OpenAI와 같은 클라이언트를 사용해서, Docker Agent가 지원하는 모든 OpenAI 기능과 완전히 호환돼요.

예시: 코드 어시스턴트

agents:
  coder:
    model: mistral/codestral-latest
    description: Expert code assistant
    instruction: |
      You are an expert programmer using Codestral.
      Write clean, efficient, well-documented code.
      Explain your reasoning when helpful.
    toolsets:
      - type: filesystem
      - type: shell
      - type: think

더 알아보기 (Learn more)