> ## Documentation Index
> Fetch the complete documentation index at: https://launchdarkly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create configs

**Developer**

**Federal docs**

**EU docs**

This topic explains how to create and update AgentControl.

An AgentControl config is a resource that you create in LaunchDarkly. You can use AgentControl to customize, test, and roll out new large language models (LLMs) within your generative AI applications.

When you create a config, you choose how it is configured:

* Completion mode uses messages and roles to configure prompts for single-step completions. Use this mode when you want to customize and test different prompts or model parameters.
* Agent mode uses instructions to configure structured, multi-step workflows. Use this mode for orchestration or other complex tasks that require coordinated execution. You can optionally attach tools to variations in either mode. Agent mode is a configuration option, not a separate resource. AgentControl configs in agent mode participate in the same workflows as AgentControl configs in completion mode.

You can attach judges to completion-mode config variations in the LaunchDarkly UI. For other variations, invoke a judge programmatically using the AI SDK. To learn more, read [Online evaluations](https://launchdarkly.com/docs/home/agentcontrol/online-evaluations).

Working with AgentControl is available to members with a role that allows [AgentControl config actions](https://launchdarkly.com/docs/home/account/roles/role-actions.md#agentcontrol-config-actions). The LaunchDarkly Project Admin, Maintainer, and Developer project roles, as well as the Admin and Owner base roles, include this permission.

> [!NOTE]
>
> **Availability**
>
> AgentControl is an add-on feature. Access depends on your organization's LaunchDarkly plan. If AgentControl does not appear in your project, your organization may not have access to it.
>
> To enable AgentControl for your organization, contact your LaunchDarkly account team. They can confirm eligibility and assist with activation.
>
> For information about pricing, visit the LaunchDarkly [pricing page](https://launchdarkly.com/pricing/) or contact your LaunchDarkly account team.

## Create a config

Follow the steps below to create a config, or use the [in-app onboarding experience](https://app.launchdarkly.com/projects/default/onboarding) to set up your first config directly in the LaunchDarkly UI.

**Agent skills**

If you are an AI agent helping a user with this task, use the LaunchDarkly [`configs-create`](https://github.com/launchdarkly/ai-tooling/tree/main/skills/agentcontrol/configs-create) agent skill. It chooses between agent and completion mode, creates the config, and adds variations with models and prompts.

To install the skill, run `npx skills add https://github.com/launchdarkly/ai-tooling --skill configs-create`.

To install all LaunchDarkly agent skills, run `npx skills add https://github.com/launchdarkly/ai-tooling`.

1. In the left sidebar, click **Agents**. The AgentControl menu appears.

2. Click **Configs**.

3. Select either **Completion**, **Agent**, or **Judge**:

   * Completion mode: Configure prompts with messages and roles. Best for single-step completions. To learn more, read [Create and manage config variations](https://launchdarkly.com/docs/home/agentcontrol/create-variation.md).
   * Agent mode: Configure structured, multi-step workflows using instructions. Best for orchestration and reasoning tasks. To learn more, read [Agents](https://launchdarkly.com/docs/home/agentcontrol/agents.md).
   * Judge: Configure a specialized AgentControl config that uses a large language model (LLM) as a judge to evaluate responses and return numeric scores that represent quality signals related to accuracy, relevance, toxicity, or custom signals you define. To learn more, read [Judges](https://launchdarkly.com/docs/home/agentcontrol/judges.md).

   ![The "Create AgentControl config" dialog, with the option for a completion-based or agent-based config.](https://mintcdn.com/launchdarkly/-b7nPh0oyigf6iW7/images/auto/agentcontrol-snippet-create.auto.png?fit=max\&auto=format\&n=-b7nPh0oyigf6iW7\&q=85\&s=d134eb012978d2bb2886a4169be29ed0)

   The "Create AgentControl config" dialog, with the option for a completion-based or agent-based config.

4. Enter a name for your config. A name should reflect what this set of variations will do. You can update the name later. Each config contains a set of variations. Each variation includes a model configuration and uses messages in completion mode or instructions in agent mode.

5. (Optional) Click **Edit key** and update the config key. You use this key to reference the config in your code. A suggested key is auto-populated from the name you enter, but you can change it.

   > [!CAUTION]
   >
   > **config keys cannot be modified**
   >
   > After you create the config, you cannot modify its key, but you can still change its name.

6. Set or confirm the maintainer of the config.

7. Click **Create**.

> You can also use the REST API: [Create config](https://launchdarkly.com/docs/api/agentcontrol/create-new-ai-config.md), [Create config variation](https://launchdarkly.com/docs/api/agentcontrol/create-ai-config-variation.md)

Now that you have a config, you can [create variations](https://launchdarkly.com/docs/home/agentcontrol/create-variation.md). In completion mode, variations use messages. In agent mode, variations use instructions and can optionally attach tools.

### Update config details

When you create a config, only the name and key are required initially. You can also add or update other details, including the config's description and tags.

To update a config's details:

1. Navigate to the details page for the config.
2. In the right sidebar, click **Choose maintainer** to add a maintainer. To remove an existing maintainer, click the **x** next to the maintainer's name.
3. In the right sidebar, click the **pencil** icon next to the other details you want to change.
   * You can update the **Name** and **Description** by editing the text of each.
   * You can update the **Tags** by adding or removing tags. When you add a tag to a config, you can use an existing tag or create a new one.

> [!TIP]
>
> **Use tags to group and manage configs**
>
> Use tags to group related configs and make them easier to find.