Upstreet AI

file: ./content/docs/changelog.mdx # undefined: What's new? Learn what the latest updates are in Upstreet-world. import Changelog from "../../../../CHANGELOG.md"; <Changelog /> file: ./content/docs/(getting-started)/create-an-agent.mdx # undefined: Create an Agent Build AI Agents in minutes with the Upstreet Agents SDK. import Wrapper from '../../../components/preview/wrapper'; import { File, Folder, Files } from 'fumadocs-ui/components/files'; import { Accordion, Accordions } from 'fumadocs-ui/components/accordion'; import { formatNodeVersion } from '../../../lib/utils'; import pkgJson from 'usdk/package.json'; <Accordions> <Accordion title="🟢 Prerequisites" defaultOpen> * Ensure your Node version is {formatNodeVersion(pkgJson.engines?.node || '>=22.9.0').toLocaleLowerCase()}. [Install Node](/install#prerequisites) * Upstreet SDK installed on your computer. [Install SDK](/install) * Logged in to SDK. Follow instructions to [log in here](/install#log-into-the-sdk). </Accordion> </Accordions> Upstreet AI Agents are persistent digital entities that can autonomously handle tasks, interact with you and your users over chat or social media, and can be customized according to your configuration. **New to designing Agents?** Explore how to define effective Agent objectives and strategies in our [Agent Design Concepts](/concepts/defining-agent-objectives). **Coming in from another platform like Tavern?** You can import your previous work into an Upstreet Agent. Check out our [Migration Guides](/migration-guides). ## Quickstart: Creating an Agent Here’s how to set up your first Agent. ### Step 1: Running the command 1. **Set up your project directory**\ First, create an empty directory where you’d like to set up your Agent. 2. **Run the Command in your terminal** ```bash 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`. <Callout> We recommend using the [`pnpm`](https://pnpm.io/installation`) (Performant Node Package Manager) package manager with your Agent. </Callout> ### Step 2: Complete the Agent Interview The `usdk create` command initiates an interactive “interview” process with the **Interviewer**. Here’s what to expect: 1. **Interactive Prompts**\ The SDK will prompt you with questions, helping you define your Agent's personality, environment, and other key settings. 2. **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. 3. **Completion**\ Once all required fields are captured, the interview concludes, setting up all the Agent features and initialising the necessary files in your directory. <Callout> Want to **skip the interview** and jump right in with coding your agent? You can use the `-p` flag to pass a single creation prompt, or the `-y` to skip the interview process and create a default agent. You can also omit the agent directory. In that case, a directory will be created for you. </Callout> To import your agent from other platforms, `usdk create` also supports [Tavern character cards](https://github.com/malfoyslastname/character-card-spec-v2) and more. See [*Importing a Tavern Agent*](/migration-guides/tavern#create-an-upstreet-agent-from-a-tavern-character-card) for more information. ### File Structure Assuming you’ve named your project directory “my-agent,” here’s the structure you’ll see post-setup: <Wrapper> <Files className="max-w-lg w-full"> <Folder name="my-agent" defaultOpen> <Folder name="wrangler" /> <Folder name="node_modules" disabled /> <Folder name="packages" /> <Folder name="codecs" /> <Folder name="tests" /> <File name=".gitignore" /> […gekürzt]