Overview
Integrate SambaNova models directly into DataRobot Workbench as custom managed LLMs. Once connected, you can:- Use SambaNova models inside RAG and Agentic Workflows
- Interact with models via Playground chat
- Manage deployments with full governance and monitoring through DataRobot
For detailed implementation guidance, see the Full SambaNova DataRobot Integration guide.
Prerequisites
- SambaCloud account and API key
- Access to DataRobot Workbench, Console, and Registry
Required files
Download the following files from the SambaNova integrations repository:custom.py— defines the chat and load_model DataRobot hooksrequirements.txt— minimal dependencies (sambanova,pandas)model-metadata.yaml— runtime parameters configuration
Setup
1
Create a Custom Model
- Navigate to Registry → Workshop → + Add Model
- Select Proxy type with
TextGenerationtarget type - Upload your
custom.py,requirements.txt, andmodel-metadata.yamlfiles
2
Build Environment
- Select
[GenAI] Python 3.12 with Moderationsas the base environment - Click Build and wait for “Environment built successfully” confirmation
3
Configure Runtime Parameters
Open the runtime parameter editor and configure the following:
SAMBANOVA_API_KEY→ your SambaNova API tokenSAMBANOVA_API_BASE→https://api.sambanova.ai/v1SAMBANOVA_MODEL→ a model ID from the SambaCloud models page

4
Register the Model
- Navigate to Registry → Models → Register Model
- Select your custom model version and click Register
- Confirm the model appears in the Registry with status Registered
5
Deploy the Model
- Go to Registry → Models → Deploy
- Select your previously registered custom model
- Wait until the deployment status shows Active

6
Link to RAG or Agentic Workflow
- In Workbench, create a new GenAI RAG use case
- Navigate to Playground → Create LLM blueprint → Add deployed LLM
- Select your deployment (e.g.,
SambaNova Chat) - Set Chat model ID to your SambaNova model name (see SambaCloud models page)
- Validate and add the configuration
- Configure your vector store, system prompt, and history management settings

Troubleshooting
Environment build fails
Environment build fails
- Confirm
[GenAI] Python 3.12 with Moderationsis selected as the base environment - Check that all three files (
custom.py,requirements.txt,model-metadata.yaml) are uploaded - Review build logs for missing dependency errors
Authentication error or model not responding
Authentication error or model not responding
- Verify
SAMBANOVA_API_KEYis correct and active in the SambaCloud portal - Confirm
SAMBANOVA_API_BASEis set tohttps://api.sambanova.ai/v1 - Confirm
SAMBANOVA_MODELmatches a valid model ID from the SambaCloud models page
Deployment not showing Active status
Deployment not showing Active status
- Wait a few minutes — deployment can take time
- Check DataRobot deployment logs for errors
- Re-deploy if status remains stuck

