Create an Agent

Upstreet AI Agents are fully customizable digital entities that autonomously handle tasks, communicate, and interact according to your configuration.

New to designing Agents? Explore how to define effective Agent objectives and strategies in our Agent Design Concepts.

Quickstart: Creating an Agent

With Upstreet, getting started is easy. Here’s how to set up your first Agent.

Step 1: Running the command

Set up your project directory
First, create an empty directory where you’d like to set up your Agent.
Run the Command in your terminal
usdk create
Run the above command in your terminal within your new directory. This will launch a guided interview, where you’ll define essential properties of your Agent.

You can see more options by running usdk create --help.

Step 2: Complete the Agent Interview

The usdk create command initiates an interactive “interview” process with the Interviewer. Here’s what to expect:

Interactive Prompts
The SDK will prompt you with questions, helping you define your Agent's personality, environment, and other key settings.
Simulated Chat with Your Agent
You’ll be able to “converse” with the Interviewer, defining the Agent's Homespace (its natural habitat) and personality traits through chat-based interactions.
Completion
Once all required fields are captured, the interview concludes, setting up all the Agent features and initialising the necessary files in your directory.

Want to skip the interview and jump right in the action? You can use the -y flag to skip the Agent Interview process. You can also omit the agent directory. In that case, a directory will be created for you.

File Structure

Assuming you’ve named your project directory “my-agent,” here’s the structure you’ll see post-setup:

agent.tsx

jest.config.mjs

jest.setup.mjs

package-lock.json

package.json

tsconfig.json

wrangler.toml

README.md

For a breakdown of these files, see our Agent Structure guide.

Remember to keep your Agent’s configuration secure. Avoid making this repository public on platforms like GitHub, as sensitive keys could be exposed.

Editing your Agent

If you wish to edit your already-created Agent through the Interview process, you may run the following command in the directory of your Agent:

usdk edit

What's next?

Now that you've set up your base Agent, you can choose to dive deeper into Agent customization and potential capabilities by writing code in React.

If you wish to skip customization and directly launch your Agent on our Platform, you can check out Testing your Agent and Deploying your Agent.