Create configs

Overview

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.

Working with AgentControl is available to members with a role that allows AgentControl config actions. The LaunchDarkly Project Admin, Maintainer, and Developer project roles, as well as the Admin and Owner base roles, include this permission.

Create a config

Follow the steps below to create a config, or use the in-app onboarding experience to set up your first config directly in the LaunchDarkly UI.

1. Click Create and choose AgentControl config to open the “Create AgentControl config” dialog.

2. Select either Completion or Agent:

   • Completion mode: Configure prompts with messages and roles. Best for single-step completions. To learn more, read Create and manage config variations.
   • Agent mode: Configure structured, multi-step workflows using instructions. Best for orchestration and reasoning tasks. To learn more, read Agents.

   

3. 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.

4. (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.

   config keys cannot be modified

   After you create the config, you cannot modify its key, but you can still change its name.

5. Set or confirm the maintainer of the config.

6. Click Create.

Now that you have a config, you can create variations. 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.