Skip to content

Profiles and models ​

A profile selects an LLM account, a model and shared instructions. Accounts and profiles are stored in PostgreSQL and managed through the web interface or API. Connectors select a profile by its stable agent.profile name.

Create a profile ​

  1. In Settings → LLM accounts, add an account and configure its authorization.
  2. In Settings → Profiles, choose Add profile. Enter a unique name, select the account and specify the required model ID.
  3. Add a description and instructions if needed. Configure the Codex options and keep the profile active.

The name is used in workflows and API requests and cannot be renamed. The model is a string identifier accepted by the selected account. A session can override it through agent.model.

Codex profiles support effort, summary, personality and service_tier. Unset options are omitted when starting the agent. Model and account support determine which values the provider accepts.

Manage profiles ​

The list supports search, activity filters and pagination. Open a profile to edit it, enable or disable it, or delete it. New sessions require both the profile and its account to be active. Disabling either does not stop accepted sessions.

To balance spending or quotas, select another account using the same harness. New sessions use the new account. Existing sessions retain their account and execution settings, including model and instructions. Changes take effect without restarting API or worker.

A deleted profile no longer admits new sessions. Existing sessions remain available. In Mattermost, use a deliberate workflow revision change to start new conversations with updated settings. In Space, reset reusable context when the next run should use a new session.

orpheus.toml contains credential-store infrastructure and service definitions. Profiles and account credentials are managed in the database catalog.