xAI

xAI (Grok)

xAI의 Grok 모델을 Docker Agent에서 사용하는 방법을 설명해요. OpenAI 호환 API로 Grok 모델 계열을 쓸 수 있어요.

출처: 문서

본문

xAI는 Grok 모델 계열을 OpenAI 호환 API로 제공해요. Docker Agent에는 xAI를 기본 제공 alias 프로바이더로 지원하고 있어요.

설정

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

사용법

인라인 문법

xAI를 쓰는 가장 간단한 방법:

agents:
  root:
    model: xai/grok-3
    description: Assistant using Grok
    instruction: You are a helpful assistant.

네임드 모델 (Named Model)

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

models:
  grok:
    provider: xai
    model: grok-3
    temperature: 0.7
    max_tokens: 8192

agents:
  root:
    model: grok
    description: Assistant using Grok
    instruction: You are a helpful assistant.

사용 가능한 모델

모델 설명 컨텍스트
grok-3 최신 가장 강력한 Grok 모델 131K
grok-3-fast 더 낮은 지연의 빠른 변형 131K
grok-3-mini 간단한 작업용 컴팩트 모델 131K
grok-3-mini-fast mini 모델의 빠른 변형 131K
grok-2 이전 세대 모델 128K
grok-vision 비전 지원 모델 32K

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

확장 생각 (Extended Thinking)

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

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

동작 방식

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

  • API 유형: OpenAI 호환(openai_chatcompletions)
  • 기본 URL: https://api.x.ai/v1
  • 토큰 변수: XAI_API_KEY

예시: 연구 어시스턴트

agents:
  researcher:
    model: xai/grok-3
    description: Research assistant with real-time knowledge
    instruction: |
      You are a research assistant using Grok.
      Provide well-researched, factual responses.
      Cite sources when available.
    toolsets:
      - type: mcp
        ref: docker:duckduckgo
      - type: think

더 알아보기 (Learn more)