Cloudera

The Cloudera provider allows you to interact with Cloudera's AI endpoints using the OpenAI protocol. It supports chat completion models hosted on Cloudera's infrastructure.

Configuration

To use the Cloudera provider, you'll need:

1. A Cloudera domain
2. A CDP token for authentication
3. (Optional) A namespace and endpoint configuration

Set up your environment:

export CDP_DOMAIN=your-domain-here
export CDP_TOKEN=your-token-here

Basic Usage

Here's a basic example of how to use the Cloudera provider:

providers:
  - id: cloudera:your-model-name
    config:
      domain: your-domain # Optional if CDP_DOMAIN is set
      namespace: serving-default # Optional, defaults to 'serving-default'
      endpoint: your-endpoint # Optional, defaults to model name

Configuration Options

The Cloudera provider supports all the standard OpenAI configuration options plus these additional Cloudera-specific options:

Example with full configuration:

providers:
  - id: cloudera:llama-3-1
    config:
      # Cloudera-specific options
      domain: your-domain
      namespace: serving-default
      endpoint: llama-3-1

      # Standard OpenAI options
      temperature: 0.7
      max_tokens: 200
      top_p: 1
      frequency_penalty: 0
      presence_penalty: 0

Environment Variables

The following environment variables are supported:

API Compatibility

The Cloudera provider is built on top of the OpenAI protocol, which means it supports the same message format and most of the same parameters as the OpenAI Chat API. This includes:

• Chat message formatting with roles (system, user, assistant)
• Temperature and other generation parameters
• Token limits and other constraints

Example chat conversation:

prompts:
  - 'You are a helpful assistant. Answer the following question: {{user_input}}'

providers:
  - id: cloudera:llama-3-1
    config:
      temperature: 0.7
      max_tokens: 200

tests:
  - vars:
      user_input: 'What should I do for a 4 day vacation in Spain?'

Troubleshooting

If you encounter issues:

1. Verify your CDP_TOKEN and CDP_DOMAIN are correctly set
2. Check that the namespace and endpoint exist and are accessible
3. Ensure your model name matches the endpoint configuration
4. Verify your token has the necessary permissions to access the endpoint