Models & Profiles

Profile 与模型路由：一步一步

本页用于建立多 profile、多模型的稳定调用方式，覆盖 alias/fallback 与配置安全变更。

步骤 1：建立基础 profile

mosaic --project-state --profile default setup \
  --base-url https://api.openai.com \
  --api-key-env OPENAI_API_KEY \
  --model gpt-4o-mini

mosaic --project-state --profile default configure --show

步骤 2：查看模型可见性

mosaic --project-state --profile default models list
mosaic --project-state --profile default models list --query gpt --limit 10
mosaic --project-state --profile default models status

步骤 3：解析与设置当前模型

mosaic --project-state --profile default models resolve
mosaic --project-state --profile default models resolve fast
mosaic --project-state --profile default models set gpt-4o-mini

步骤 4：用 alias 统一调用语义

mosaic --project-state --profile default models aliases set fast gpt-4o-mini
mosaic --project-state --profile default models aliases set deep gpt-4.1-mini
mosaic --project-state --profile default models aliases list
mosaic --project-state --profile default models aliases remove deep

步骤 5：配置 fallback 链路

mosaic --project-state --profile default models fallbacks add gpt-4.1-mini
mosaic --project-state --profile default models fallbacks add gpt-4o-mini
mosaic --project-state --profile default models fallbacks list
mosaic --project-state --profile default models fallbacks remove gpt-4.1-mini

步骤 6：安全修改配置

mosaic --project-state --profile default configure keys
mosaic --project-state --profile default configure get provider.model
mosaic --project-state --profile default configure set agent.max_turns 10
mosaic --project-state --profile default configure unset agent.max_turns

mosaic --project-state --profile default configure patch --set provider.model=gpt-4o-mini --dry-run
mosaic --project-state --profile default configure preview --set provider.model=gpt-4o-mini
mosaic --project-state --profile default configure template --format toml --defaults

步骤 7：添加第二个 profile（Azure 示例）

export AZURE_OPENAI_BASE_URL="https://<resource>.openai.azure.com/openai/v1"
export AZURE_OPENAI_API_KEY="<your_key>"

mosaic --project-state --profile az-openai setup \
  --base-url "$AZURE_OPENAI_BASE_URL" \
  --api-key-env AZURE_OPENAI_API_KEY \
  --model gpt-4o-mini

mosaic --project-state --profile az-openai models list

步骤 8：自动化 JSON 校验

mosaic --project-state --profile default --json models list --query gpt --limit 5
mosaic --project-state --profile default --json models status
mosaic --project-state --profile default --json configure --show

验收清单

• 至少两个 profile 可独立执行 models list。
• alias/fallback 配置可见且可解析。
• configure patch/preview 可安全用于变更评估。
• JSON 输出可稳定供 CI 脚本解析。