Build a simple agent

This guide walks you through building a minimal working agent end to end. Once the base agent is set up, you can explore how to extend it with additional features, each linked to the relevant documentation.

The minimum required artifacts are an AI model and an agent. Because the agent depends on the model, start with the model.

Create a model

Choosing the right provider and model depends on your agent’s purpose and the type of interaction you want to support.

  1. In the Cockpit, open the Model tool.

  2. Select Create.

  3. Select a provider.

  4. Set Input Type to Text and Output Type to Text. This ensures the model is an LLM and not an embedding model.

  5. Fill in the remaining fields and select Create.

  6. Add your API key or other required credentials, then select Save.

Now that you have a model, you can create an agent that uses it.

Create an agent

  1. In the Cockpit, open the Agent tool.

  2. Select Create.

  3. Select your model, fill in the remaining required fields, and select Create.

For an agent to work it needs an instruction. Navigate to the Instructions tab to set one up:

  1. Open the Instructions tab.

  2. Create a custom instruction or select one of the provided examples.

  3. Select Save.

Test your agent

You can test the agent directly in the Playground tab.

Default behavior

A minimal agent created with the steps above has the following default properties:

Related topics