Create AI Config variation

POST

/api/v2/projects/:projectKey/ai-configs/:configKey/variations

POST

/api/v2/projects/:projectKey/ai-configs/:configKey/variations

$ curl -X POST https://app.launchdarkly.com/api/v2/projects/projectKey/ai-configs/configKey/variations \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "key": "key",
>   "name": "name",
>   "comment": "comment",
>   "description": "description",
>   "instructions": "instructions",
>   "messages": [
>     {
>       "content": "content",
>       "role": "role"
>     },
>     {
>       "content": "content",
>       "role": "role"
>     }
>   ],
>   "model": "{}",
>   "modelConfigKey": "modelConfigKey",
>   "modelConfigVersion": 1,
>   "outputFormat": {
>     "key": ""
>   },
>   "tools": [
>     {
>       "key": "key",
>       "version": 6
>     },
>     {
>       "key": "key",
>       "version": 6
>     }
>   ],
>   "toolKeys": [
>     "toolKeys",
>     "toolKeys"
>   ],
>   "skills": [
>     {
>       "key": "key",
>       "version": 1
>     },
>     {
>       "key": "key",
>       "version": 1
>     }
>   ],
>   "judgeConfiguration": {
>     "judges": [
>       {
>         "judgeConfigKey": "judgeConfigKey",
>         "samplingRate": 0.36160767
>       },
>       {
>         "judgeConfigKey": "judgeConfigKey",
>         "samplingRate": 0.36160767
>       }
>     ]
>   }
> }'

1 {
2   "key": "key",
3   "_id": "_id",
4   "model": "{}",
5   "name": "name",
6   "createdAt": 1,
7   "version": 5,
8   "_links": {
9     "parent": {
10       "href": "href",
11       "type": "type"
12     }
13   },
14   "color": "color",
15   "comment": "comment",
16   "description": "description",
17   "instructions": "instructions",
18   "messages": [
19     {
20       "content": "content",
21       "role": "role"
22     },
23     {
24       "content": "content",
25       "role": "role"
26     }
27   ],
28   "modelConfigKey": "modelConfigKey",
29   "modelConfigVersion": 6,
30   "outputFormat": {
31     "key": ""
32   },
33   "state": "state",
34   "_archivedAt": 5,
35   "_publishedAt": 2,
36   "tools": [
37     {
38       "key": "key",
39       "version": 7,
40       "customParameters": {
41         "key": ""
42       }
43     },
44     {
45       "key": "key",
46       "version": 7,
47       "customParameters": {
48         "key": ""
49       }
50     }
51   ],
52   "skills": [
53     {
54       "key": "key",
55       "version": 9
56     },
57     {
58       "key": "key",
59       "version": 9
60     }
61   ],
62   "judgeConfiguration": {
63     "judges": [
64       {
65         "judgeConfigKey": "judgeConfigKey",
66         "samplingRate": 0.36160767
67       },
68       {
69         "judgeConfigKey": "judgeConfigKey",
70         "samplingRate": 0.36160767
71       }
72     ]
73   },
74   "judgingConfigKeys": [
75     "judgingConfigKeys",
76     "judgingConfigKeys"
77   ]
78 }

Create a new variation for a given AI Config.

The model in the request body requires a modelName and parameters, for example:

  "model": {
    "modelName": "claude-3-opus-20240229",
    "parameters": {
      "max_tokens": 1024
    }
  }

Create a new variation for a given AI Config. The <code>model</code> in the request body requires a <code>modelName</code> and <code>parameters</code>, for example: ``` "model": { "modelName": "claude-3-opus-20240229", "parameters": { "max_tokens": 1024 } } ```

Authentication

Authorizationstring

API Key authentication via header

Path parameters

projectKeystringRequired

configKeystringRequired

Request

AI Config variation object to create

keystringRequired

namestringRequired

commentstringOptional

Human-readable description of this variation

descriptionstringOptional

Returns the description for the agent. This is only returned for agent variations.

instructionsstringOptional

Returns the instructions for the agent. This is only returned for agent variations.

messageslist of objectsOptional

modelobjectOptional

modelConfigKeystringOptional

modelConfigVersionintegerOptional>=1

The exact model config version to set this variation to. Requires modelConfigKey to be set, and the version must exist for that model config. When omitted, the variation records the model config’s current (latest) version.

outputFormatmap from strings to anyOptional

JSON Schema defining the structured output format for the variation.

toolslist of objectsOptional

List of tools to use for this variation. The latest version of the tool will be used.

toolKeyslist of stringsOptional

List of tool keys to use for this variation. The latest version of the tool will be used.

skillslist of objectsOptional

List of agent skills to attach to this variation.

judgeConfigurationobjectOptional

Response

AI Config variation created

keystring

_idstring

modelobject

namestring

createdAtlong

versioninteger

_linksobjectOptional

colorstringOptional

commentstringOptional

descriptionstringOptional

Returns the description for the agent. This is only returned for agent variations.

instructionsstringOptional

Returns the instructions for the agent. This is only returned for agent variations.

messageslist of objectsOptional

modelConfigKeystringOptional

modelConfigVersionintegerOptional

The version of the model config that this variation is pinned to, when it references a custom model config. Absent when the variation does not reference a model config, when the variation is not pinned to a specific version, or when custom model config versioning is not enabled for the project.

outputFormatmap from strings to anyOptional

JSON Schema defining the structured output format for the variation.

statestringOptional

_archivedAtlongOptional

_publishedAtlongOptional

toolslist of objectsOptional

skillslist of objectsOptional

judgeConfigurationobjectOptional

judgingConfigKeyslist of stringsOptional

Errors

400

Bad Request Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error