본문으로 건너뛰기

문서 Pi / Oh My Pi

도구 연동

Pi / Oh My Pi

Pi와 Oh My Pi의 서로 다른 설정 형식을 확인하세요.

준비물#

Pi 또는 Oh My Pi를 설치하고 콘솔에서 키를 준비하세요. 도구를 실행할 터미널에 키를 설정하세요.

셸
export MORPH_API_KEY="your-api-key"

Pi#

~/.pi/agent/models.json의 providers 안에 morph를 추가하세요. 기존 provider는 유지하세요. 이 예제는 Pi 1.3.0 설정 형식을 따릅니다.

models.json
{
  "providers": {
    "morph": {
      "baseUrl": "https://api.dev.morphfactory.io/v1",
      "api": "openai-completions",
      "apiKey": "$MORPH_API_KEY",
      "compat": { "supportsDeveloperRole": false },
      "models": [
        { "id": "motif/motif-3", "name": "Motif-3", "input": ["text"], "reasoning": true }
      ]
    }
  }
}

supportsDeveloperRole: false는 system, user, assistant, tool 역할을 받는 게이트웨이에 developer 역할을 보내지 않도록 합니다. 이 예제에서는 해당 호환 설정을 유지하세요.

셸
pi --provider morph --model motif/motif-3

Oh My Pi#

기본 프로필의 ~/.omp/agent/models.yml에 provider를 추가하세요. 들여쓰기와 기존 항목을 유지하세요. Pi와 달리 환경 변수 이름 앞에 $를 붙이지 않습니다.

models.yml
providers:
  morph:
    baseUrl: https://api.dev.morphfactory.io/v1
    api: openai-completions
    apiKey: MORPH_API_KEY
    models:
      - id: motif/motif-3
        name: Motif-3
셸
omp --model morph/motif/motif-3

문제 해결#

Pi에서 역할 관련 422가 나오면 compat 블록을 확인하세요. Oh My Pi에서 401이 나오면 apiKey가 $ 없는 MORPH_API_KEY인지, 실행한 터미널에 환경 변수가 설정되어 있는지 확인하세요. 모델을 선택한 뒤 짧은 텍스트 질문을 보내세요.

공식 Pi 모델 설정, Oh My Pi 설정, 오류 및 문제 해결을 참고하세요.