Configuring BYOM

Supported Models

When configuring a model, the BYOM CLI requires several mandatory configuration fields. These values must be obtained from the selected model provider and supplied during the configuration process.

For more information about the supported models and configurations, refer to Supported Models.

Configuring BYOM

Before you begin

If a PPC CLI session was opened before installing the Agent, it will not detect the new installation. After installing the Agent, start a new PPC CLI session before configuring BYOM. Do not reuse an existing session. This applies whenever you configure or update BYOM, not only immediately after installation. If the base Agent URL has changed, exit all existing sessions gracefully and start a new session so it uses the updated URL.

Configuring BYOM

To configure BYOM, perform the following steps:

1. Log in to the CLI using an user with agent-model-administrator permissions.

2. To fetch the current model, run the following command:

   agent get model-config
   

3. To configure the model configuration, run the following command:

   agent set model-config \
   --chat      '{"provider": "<provider-name>", "api_key": "<your-provider-key>", "model": "<required model>"}' \
   --embedding '{"provider": "<provider-name>", "api_key": "<your-provider-key>", "model": "<required model>"}'
   

   For more information about the required values, refer to Supported Models.

   The following is an example using Anthropic Claude and VoyageAI.

   agent set model-config \
    --chat      '{"provider": "anthropic", "api_key": "<your-anthropic-key>", "model": "claude-sonnet-4-6"}' \
    --embedding '{"provider": "voyage",    "api_key": "<your-voyage-key>",    "model": "voyage-3"}'
   

4. To patch the model configuration, run the following command:

   agent patch model-config \
    --chat '{"provider": "<provider-name>", "api_key": "<your-provider-key>", "model": "<required model>"}'
   

   The following is an example using Anthropic Claude and VoyageAI.

   agent patch model-config \
    --chat '{"provider": "anthropic", "api_key": "<your-anthropic-key>", "model": "claude-sonnet-4-6"}'