Skip to content

Commit bf774e9

Browse files
committed
docs(inference): clarify rollback recovery
Signed-off-by: Prekshi Vyas <prekshiv@nvidia.com>
1 parent 3edb735 commit bf774e9

2 files changed

Lines changed: 4 additions & 2 deletions

File tree

docs/inference/switch-providers.mdx

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,8 @@ Use `--no-verify` only when OpenShell cannot verify the target provider at switc
7575
This flag does not bypass shared-gateway compatibility checks.
7676
For a validated compatible-provider binding at `http://host.openshell.internal:<port>`, NemoClaw skips OpenShell's host-side provider probe because that hostname resolves only inside the sandbox network.
7777
It then sends one minimal request from the target sandbox before persisting the route in NemoClaw state; the request allows up to 16 output tokens.
78-
If that request fails, NemoClaw restores the previous OpenShell selection and removes a provider that this switch created.
78+
If that request fails, NemoClaw attempts to restore the previous OpenShell selection and remove a provider that this switch created.
79+
If the error reports that rollback could not complete, re-run onboarding before using or retrying the route.
7980
Endpoint-shape and shared-gateway compatibility checks still apply.
8081

8182
</AgentOnly>

docs/reference/commands.mdx

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4102,7 +4102,8 @@ Supported provider names are `nvidia-prod`, `nvidia-nim`, `nvidia-router`, `open
41024102
Use `--no-verify` only when OpenShell cannot verify the provider at switch time but you have already confirmed the provider and credential.
41034103
For a validated compatible-provider binding at `http://host.openshell.internal:<port>`, NemoClaw skips OpenShell's host-side provider probe because that hostname resolves only inside the sandbox network.
41044104
Before it persists the route in the NemoClaw registry or agent config, the command sends one request from the target sandbox with a 16-token output limit.
4105-
If that request fails, the command restores the previous OpenShell selection and removes a provider that this switch created.
4105+
If that request fails, the command attempts to restore the previous OpenShell selection and remove a provider that this switch created.
4106+
If the error reports that rollback could not complete, re-run onboarding before using or retrying the route.
41064107
Endpoint-shape and shared-gateway compatibility checks still apply.
41074108
When switching to `compatible-endpoint` or `compatible-anthropic-endpoint` from a different provider family, pass `--endpoint-url` with the trusted custom provider URL and, except for the Hermes case below, `--inference-api` with its API family so NemoClaw can persist a complete route identity for rebuild and shared-gateway checks.
41084109
For a Hermes `compatible-anthropic-endpoint` target, `--inference-api` may be omitted because NemoClaw deterministically selects `openai-completions`; an explicit different API family is rejected.

0 commit comments

Comments
 (0)