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

# Tutorial: Creating your first agent with the Agent builder

In this tutorial, you'll follow a step-by-step guide to create your first agent with the Agent builder.

## Before you begin

Before you start to follow this tutorial, you must set up your IBM watsonx Orchestrate ADK environment, where you build agents and tools. It also provides a convenient interface for managing credentials, sending requests, and handling responses from the service's APIs. See the [Installing the watsonx Orchestrate ADK](../getting_started/installing) and [Installing the watsonx Orchestrate Developer Edition](../developer_edition/wxOde_setup).

## Developing the 'Hello world' agent

The following steps guide you to make you agent available on Agent builder.

1. In your directory, create a folder with the name **hello-world**.

2. Open a text editor, such as Visual Studio Code.

3. To create the agent, copy the following code:

   ```yaml YAML [expandable] theme={null}
   spec_version: v1
   kind: native
   name: greeter
   description: An agent that greets you using the output from its tool
   instructions: Always run the tool "Greeting" when the user types Greeting in the chat. 
   llm: groq/openai/gpt-oss-120b
   style: default
   collaborators: []
   tools: 
   - greeting
   ```

4. Paste the code in the text editor and save the file as `greeter.yaml` in the \**hello-world* folder.

5. To create the tool, copy the following code:

   ```py Python [expandable] theme={null}
   #greetings.py
   from ibm_watsonx_orchestrate.agent_builder.tools import tool


   @tool
   def greeting() -> str:
       """
       Greeting for everyone   
       """

       greeting = "Hello World"
       return greeting
   ```

6. Paste the code in the text editor and save the file as `greetings.py` in the \**hello-world* folder.

7. Open the terminal that you commonly use.

8. Navigate to the folder. For instance, `cd ~/Desktop/hello-world`.

9. Run the command `orchestrate tools import -k python -f tools/greetings.py`.

10. Run the command `orchestrate agents import -f greeter.yaml`.

11. Run the command `orchestrate chat start`.

## Testing your agent

After the configuration, you can enter "Greeting" into the chat window and continue interacting with your agent.