-
Notifications
You must be signed in to change notification settings - Fork 1k
docs: stop promising a 429 failover kill switch that no longer exists #3520
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -169,7 +169,7 @@ affinity 초기화 뒤의 기존 작업도 포함될 수 있습니다. 출력 | |
|
|
||
| | 키 | 타입 | 기본값 | 설명 | | ||
| | --- | --- | --- | --- | | ||
| | `anthropicAccountPool.enabled?` | `boolean` | `false` | sticky 결속과 429 쿨다운 failover를 켭니다. | | ||
| | `anthropicAccountPool.enabled?` | `boolean` | `false` | sticky 세션 결속과 사용량 기반 새 세션 선택을 켭니다. **429 failover는 여기서 제어되지 않습니다**: 쓸 수 있는 계정이 둘 이상이면 다른 다중 자격 증명 제공자와 똑같이 자동으로 켜지며, 끌 수 없습니다. | | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. 🎯 Functional Correctness | 🟠 Major | ⚡ Quick win Remove the stale The new table rows correctly state that
As per path instructions, translated documentation must remain synchronized with the current CLI/API behavior. 📍 Affects 3 files
🤖 Prompt for AI AgentsSource: Path instructions |
||
| | `anthropicAccountPool.autoSwitchThreshold?` | `number` | `80` | 새 세션에서는 활성 계정이 이 임계값에 도달하면 설정된 창의 알려진 캐시 사용량이 가장 낮은 계정을 고릅니다. `0`이면 quota 선택을 끕니다. | | ||
| | `anthropicAccountPool.strategy?` | `"quota" \| "round-robin" \| "fill-first"` | `"quota"` | 새 세션 전략입니다. `quota`는 `quotaWindow`로 지정한 창(기본값은 5시간 막대)으로 계정 순위를 매기고, `fill-first`도 같은 창에서 소진 임계값을 판정합니다. | | ||
| | `anthropicAccountPool.quotaWindow?` | `"five-hour" \| "weekly" \| "max-utilization"` | `"five-hour"` | 사용량 기반 계정 선택에 사용하는, 공급자가 보고한 캐시 사용률 막대입니다. `five-hour`는 기존 동작을 유지합니다. `weekly`는 주간 막대를 사용하며 다른 사용 가능한 계정이 남아 있을 때만 5시간 막대가 소진된 계정을 건너뛰고, 아무 계정도 남지 않으면 해당 계정으로 폴백합니다. `max-utilization`은 알려진 값 중 가장 높은 값을 사용하므로 주간 사용량을 알기 전에도 5시간 사용량을 쓸 수 있고, 둘 다 모르면 unknown 순서를 따릅니다. 알려진 사용량은 unknown보다 앞서지만, 사용 가능한 계정이 모두 unknown이어도 사용 가능한 순서의 계정을 선택합니다. 앞서 설명한 5시간 사용량 동점 판정 뒤에도 완전히 같으면 사용 가능한 순서를 유지합니다. 정상 affinity 세션을 선제적으로 재배치하지 않습니다. 새 세션 배정과 가능한 429 대체 이후 라우팅 복구에서 `quota`는 이 창으로 사용 가능한 후보의 순위를 직접 매기고, `fill-first`는 이 창의 임계값과 소진 규칙에 따라 안정 순서로 이동하며, `round-robin`은 이 설정을 무시합니다. 쿨다운, failover 한도, 재인증 가능 여부는 별도의 로컬 상태로 유지됩니다. 계정별 주간 막대는 대시보드의 프로바이더 페이지에서 조회한 뒤에만 알 수 있습니다. | | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win
Limit the threshold-0 wording to proactive switching.
The canonical English documentation states that
autoSwitchThreshold: 0disables proactive usage-based switching only. New-session selection and recovery after an eligible 429 still usequotaWindow. These translated rows instead say that threshold 0 disables quota selection.docs-site/src/content/docs/fr/reference/configuration/providers.md#L202: describe0as disabling proactive usage-based switching only.docs-site/src/content/docs/ja/reference/configuration/providers.md#L169: describe0as disabling proactive usage-based switching only.docs-site/src/content/docs/zh-cn/reference/configuration/providers.md#L167: describe0as disabling proactive usage-based switching only.docs-site/src/content/docs/zh-tw/reference/configuration/providers.md#L135: describe0as disabling proactive usage-based switching only.As per path instructions: translated content must not contradict the English source.
🧰 Tools
🪛 LanguageTool
[style] ~202-~202: Un autre mot peut être plus précis.
Context: ...tteint ce seuil, choisir la plus faible utilisation connue et mise en cache dans la fenêtre config...
(CELEBRE)
[typographical] ~202-~202: Caractère d’apostrophe incorrect.
Context: ...se en cache dans la fenêtre configurée.
0désactive la sélection selon le quota...(APOS_INCORRECT)
📍 Affects 4 files
docs-site/src/content/docs/fr/reference/configuration/providers.md#L202-L202(this comment)docs-site/src/content/docs/ja/reference/configuration/providers.md#L169-L169docs-site/src/content/docs/zh-cn/reference/configuration/providers.md#L167-L167docs-site/src/content/docs/zh-tw/reference/configuration/providers.md#L135-L135🤖 Prompt for AI Agents
Source: Path instructions