OpenAI Model Connector
The OpenAI Model Connector defines OpenAI as the LLM provider and default model for your Worker Agents.
What will you learn in this topic?
By the end of this topic, you will be able to:
- Understand which OpenAI models the connector supports.
- Configure reasoning effort levels for cost and latency tradeoffs.
- Configure authentication, the default model, and reasoning effort.
- Use the Harness-managed connector if you do not have model access.
Before you begin
Before you configure the OpenAI Model Connector, ensure you have the following:
- Harness AI enabled: Harness AI must be active for your account. Go to Overview for more information on activating Harness AI.
- OpenAI API access: An active OpenAI account with API key access for GPT models.
- Harness secret: A configured secret to store your OpenAI API key. Go to Add and reference text secrets for more information on creating secrets.
- Connector permissions: Permission to create and manage connectors in your Harness project. Go to RBAC in Harness for more information on permissions.
Supported models
The OpenAI Model Connector supports GPT-5.5 with configurable reasoning effort. Select the model that best fits your Worker Agent use case based on reasoning requirements, speed, and cost.
The OpenAI Model Connector supports GPT-5.5 with configurable reasoning effort.
Reasoning effort levels
The reasoning effort level controls how much reasoning the model applies before responding, trading latency and cost against depth. Set the reasoning effort level on the connector configuration form based on your task complexity requirements.
| Effort level | Description |
|---|---|
low | Fastest, lowest-cost responses for simple tasks |
medium | Balanced reasoning and latency for most tasks |
high | Deeper reasoning for complex tasks |
xhigh | Maximum reasoning depth for the most demanding tasks |
Connector configuration
Configure the connector with your OpenAI authentication, default model, and reasoning effort settings.
When you create the connector, set the following:
- Authentication: Provide an OpenAI API key. Reference the key from a Harness secret rather than entering it in plain text.
- Model Name: Select the default model (GPT-5.5) the agent uses at runtime.
- Reasoning Effort: Select the default effort level (
low,medium,high, orxhigh).
Next steps
- Go to Worker Agents for more information on creating and configuring agents that use this connector.
- Go to Anthropic Model Connector for more information on configuring Claude as your model provider.