워크스페이스 환경설정

엔드포인트: /api/workspaces/preferences/

워크스페이스 설정 > 일반에 표시되는 워크스페이스 전체 환경설정을 조회하고 변경합니다. 에이전트 업데이트 정책도 여기에 포함됩니다. 워크스페이스마다 환경설정 객체가 하나씩 있습니다.

GET /api/workspaces/preferences/-/

{
  "front_url": "https://your-workspace.ap1.alpacon.io",
  "country": "US",
  "language": "en",
  "timezone": "America/New_York",
  "invite_ttl": 172800,
  "enabled_extensions": ["metrics"],
  "websh_session_timeout": 86400,
  "agent_rollout_policy": {
    "mode": "latest",
    "window": {
      "days": [0, 1, 2, 3, 4],
      "start_hour": 2,
      "length_hours": 4,
      "timezone": "America/New_York"
    }
  },
  "auto_agent_upgrade": true,
  "package_proxy": null,
  "activity_report_cadence": ["weekly"],
  "billing_email": "billing@example.com"
}

PATCH /api/workspaces/preferences/-/

{
  "agent_rollout_policy": {
    "window": {
      "days": [5, 6],
      "start_hour": 22,
      "length_hours": 6,
      "timezone": "Asia/Seoul"
    }
  }
}

에이전트 롤아웃 정책

agent_rollout_policy는 Alpacon이 이 워크스페이스의 에이전트를 자동으로 업그레이드할지, 업그레이드한다면 어느 시간대에 진행할지 결정합니다.

{
  "mode": "latest",
  "window": {
    "days": [0, 1, 2, 3, 4, 5, 6],
    "start_hour": 0,
    "length_hours": 24,
    "timezone": "UTC"
  }
}

위 예시는 기본값입니다. latest 모드에서 매일 24시간 업그레이드 시간대가 열리므로 언제든 업그레이드를 시작할 수 있습니다.

변경 요청에는 객체의 일부만 지정할 수 있습니다. mode만 지정하거나 window의 필드 하나만 지정해도 되며, 생략한 값은 현재 값으로 유지됩니다. 조회할 때는 항상 객체 전체가 반환됩니다.

Alpacon은 매주 월요일에 그 주의 자동 업그레이드를 지정된 시간대 안으로 계획합니다. 시간대를 변경하면 다음 월요일에 세우는 계획부터 적용됩니다. 이미 계획된 업그레이드가 변경 후 시간대 밖에 놓이면 다음으로 시간대가 열릴 때까지 기다립니다.

서버 API의 각 서버 agent_upgrade_policy 필드에는 현재 mode가 담겨 있습니다.

지원 중단 예정인 auto_agent_upgrade

auto_agent_upgrade는 agent_rollout_policy로 대체된 불리언 값입니다. 앞으로 한 릴리스 동안 더 읽고 쓸 수 있으며, 그 뒤에는 삭제됩니다. 대신 agent_rollout_policy를 사용하세요.

• 읽기: mode가 manual이 아니면 true를 반환함
• true 쓰기: mode를 latest로 설정함. 이미 자동 모드(latest 또는 n_minus_1)이면 변경하지 않음
• false 쓰기: mode를 manual로 설정함
• 두 쓰기 모두 시간대(window)는 바꾸지 않음
• 요청에 두 필드가 모두 있으면 agent_rollout_policy를 적용하고 auto_agent_upgrade는 무시함
• JSON 불리언 값만 허용하며, 다른 값은 invalid_input으로 거부함

위 규칙은 REST API 기준입니다. Alpacon MCP 서버는 자체 auto_agent_upgrade 입력을 이 엔드포인트를 호출하기 전에 조금 다른 규칙으로 변환합니다. 자세한 내용은 MCP 참고 문서를 확인하세요.

오류 응답