Skip to main content
Note: To use AI Builder in watsonx Orchestrate Developer Edition, enable the feature by adding the --with-ai-builder flag to the orchestrate server start command. For more information, see Installing watsonx Orchestrate Developer Edition: watsonx Orchestrate server.
Use Orchestrate AI Builder to guide the agent creation flow. Start from scratch and build the agent through a natural conversation with you.
BASH
orchestrate agents ai-builder create
Command examples
Basic agent creation:
BASH
orchestrate agents ai-builder create -o output.yaml
Orchestrate AI Builder interaction example The following example shows how you interact with Orchestrate AI Builder to create an agent. In this case, you already created and imported the string_reverser tool into your local instance.
BASH
🤖 Builder: To create a configuration for your agent in the IBM Watsonx Orchestrate platform, let's start by describing the functionality of your agent. What tasks do you want your agent to 
perform, and what kind of operations should it be able to handle? Please provide a detailed or high-level description of your agent's intended functionality.

👤 You: I want to create an agent that can reverse strings

🤖 Builder: Based on your agent description, I've sorted the available tools by their relevancy and suggest the following tools for your agent:

1. **string_reverser**: A tool that can reverse any provided string.

Please select the tools you want your agent to use by specifying their numbers or names. If you want to see the full list of available tools, I can provide that as well. 

Remember, you can choose one, multiple, or no tools for your agent.

👤 You: 1

🤖 Builder: You have selected the **string_reverser** tool for your agent.

🤖 Builder: Based on your task description, I'll create an initial prompt. 

**Role** - 
You are an agent that can reverse strings according to the user's input.

**Tool Usage Guidelines** - 
1. Before you call a tool, make sure you have all the required tool parameters.
2. Do NOT assume any tool parameters
3. Do NOT pass parameters to the tool that are not explicitly defined
4. Do NOT call the same tool multiple times with the same parameters

**How To Use Tools**

- When the user wants to reverse a string, call the string_reverser tool with the string as a parameter.

Here's my initial prompt. How would you like the output to be formatted? Would you like it to be in a specific format, such as uppercase or lowercase?

👤 You: No use that prompt its perfect

╔═════════════════════════════════════════╗
║  Your agent building session finished successfully!             ║
║  Agent YAML saved in file:                                      ║
║  /Users/user123/output.yaml                                     ║
╚═════════════════════════════════════════╝