LLM providers - MUTAGENT

An LLM provider holds the model key a workspace uses (bring your own key). The TypeScript SDK lists, adds and tests LLM providers. The calls are on client.llmProviders and take your API key. The key you send is stored encrypted, and no call returns it.

import { Mutagent } from '@mutagent/sdk';
import { LlmProviderType } from '@mutagent/sdk/models';

const client = new Mutagent({
  serverURL: 'https://api.mutagent.io',
  security: { apiKey: process.env.MUTAGENT_API_KEY! },
});

const created = await client.llmProviders.createProviderConfig({
  name: 'OpenAI',
  provider: LlmProviderType.Openai,
  apiKey: process.env.OPENAI_API_KEY!,
});

const { configs } = await client.llmProviders.listProviderConfigs();
console.log(configs.map((config) => `${config.name} ${config.provider}`));

const result = await client.llmProviders.testProviderConfig({ id: created.id });
console.log(result.success, result.message);

Call	What it does
`createProviderConfig`	Adds an LLM provider: `name`, `provider` (`LlmProviderType`), and the key as `apiKey`. The key is tested with the LLM provider first. If the test fails, the call throws the provider’s error and nothing is saved.
`listProviderConfigs`	Lists the workspace’s LLM providers as `configs`, with `total`.
`testProviderConfig`	Calls the LLM provider with the stored key and returns `success` and `message`.

LLM provider calls act in the workspace of a workspace API key. With an organization API key, also send the x-workspace-id header in the request options, for example { headers: { 'x-workspace-id': '<workspace-id>' } }. The same work from the command line: mutagent providers.