Skip to content

SambaNova ​

The SambaNova provider uses provider key sambanova and the HPD-Agent.Providers.SambaNova package. It is backed by HPD's shared OpenAI-compatible chat-completions client, so ModelName is a SambaNova chat model id.

Set an API key:

bash
export SAMBANOVA_API_KEY="..."

The default endpoint is https://api.sambanova.ai/v1/, which sends chat requests to chat/completions. Pass endpoint to WithSambaNova(...), set Endpoint in ChatClientConfig, or use SAMBANOVA_ENDPOINT / SAMBANOVA_BASE_URL when you need a compatible proxy or custom base URL.

Use fluent chat setup first:

csharp
using HPD.Agent;
using HPD.Agent.Providers.SambaNova;

var agent = await new AgentBuilder()
    .WithSambaNova(model: "Meta-Llama-3.3-70B-Instruct")
    .BuildAsync();

var result = await agent.RunAsync("Write one sentence about SambaNova setup.");
Console.WriteLine(result.Text);

The equivalent Clients.Chat shape is:

json
{
  "Clients": {
    "Chat": {
      "ProviderKey": "sambanova",
      "ModelName": "Meta-Llama-3.3-70B-Instruct"
    }
  }
}

Runtime Chat Options ​

Use ChatClientConfig for shared model-call behavior such as temperature, top-p, max output tokens, stop sequences, response format, tools, tool mode, seed, and generic reasoning options. Put agent-level defaults in AgentConfig.Clients.Chat; use AgentRunConfig.Clients.Chat for complete per-run replacements.

Caveats ​

This provider currently registers the chat family only. Other endpoint families, if the upstream service exposes them, are deferred until HPD has dedicated provider-family support for that surface.

Chat uses HPD's shared OpenAI-compatible chat-completions client. It supports token streaming, function tools, response format and tool mode, seed, max output tokens, top-p, temperature, and stop sequences where the selected model supports them.

Runtime validation checks model and endpoint configuration. Runtime chat options are applied through Clients.Chat and AgentRunConfig.Clients.Chat. Credentials are resolved lazily when a run first acquires this provider client; a missing credential fails that run, not BuildAsync().

Built for production .NET agent applications.