# Getting Started

Build your first AI workflow in 10 minutes. In this tutorial, you'll create a people research agent that uses advanced LLM-powered search tools to extract and structure information about individuals.

## What You'll Build

A people research agent that:

1. Accepts user input through a chat interface
2. Searches the web using AI-powered tools (Exa and Linkup)
3. Extracts and structures information about individuals
4. Returns formatted JSON data with location, profession, and education

![Getting Started Example](https://docs.steelengine.com/static/getting-started/started-1.png)

## Step-by-Step Tutorial

**Land on your dashboard**

SteelEngine accounts are created by invitation. Open the invitation email, create your account from its link with the address it was sent to, and accept. You land in the workspace you were invited to:

```
/<org-slug>/<workspace-slug>/home
```

On a new self-hosted install with no accounts yet, the first person signs up at `/signup` without an invitation and becomes the first admin, then invites everyone else.

If you reach the app without belonging to any organization, and the app has no invitation to send you to, SteelEngine creates a **personal organization** for you with a default workspace inside it instead. The first admin of a new install lands here. Its org slug is generated from a curated word-pair list (e.g. `mild-owl`); the workspace slug is a short random string. You don't have to name anything to get started — but if you want to, click the workspace name at the top of the sidebar (or press `Mod` + `O`) to open the workspace switcher, where you can create another workspace or invite teammates. To rename a workspace, right-click it in the switcher and choose **Rename**. To rename the organization, open **Organization Settings → General**.

See [Organizations and Workspaces](/organizations) for the full slug rules and what changes when you upgrade to a team plan.

**Create a workflow and add an AI agent**

Click **New workflow*&#x2A; (the &#x2A;*+** button in the sidebar's **Workflows** header) and name it "Getting Started".

New workflows use platform execution defaults. If your workflow needs a specific time limit, right-click it in the sidebar and choose **Execution timeout**. Enter seconds, or leave it blank for the default. See [Workflow Timeouts](/execution#workflow-timeouts) for how waits and approvals count.

Every new workflow includes a **Start block** by default—this is the entry point that receives user input. Since we'll trigger this workflow via chat, no configuration is needed for the Start block.

Drag an **Agent Block** onto the canvas from the **Toolbar** tab of the panel on the right and configure it:

* **Model**: Select an OpenAI model such as GPT-4o
* **System Prompt**: "You are a people research agent. When given a person's name, use your available search tools to find comprehensive information about them including their location, profession, educational background, and other relevant details."
* **User Prompt**: Drag the connection from the Start block's output into this field to connect `<start.input>` to the user prompt

[Video: started-2.mp4](https://d4h6f8f5tksdw.cloudfront.net/getting-started/started-2.mp4)

**Add search tools to the agent**

Enhance your agent with web search capabilities. Click on the Agent block to select it.

In the **Tools** section:

* Click the &#x2A;*Add tool...** field
* Select **Exa** and **Linkup** from the available tools
* Provide your API keys for both tools to enable web search and data access

[Video: started-3.mp4](https://d4h6f8f5tksdw.cloudfront.net/getting-started/started-3.mp4)

**Test your workflow**

Test your workflow using the **Chat panel**, the floating panel that opens over the right side of the canvas. If it is not open, right-click the canvas and choose **Open Chat**. This panel runs the workflow you are building. It is not the **Assistant** tab in the side panel.

In the chat panel:

* Click the **Outputs** dropdown and select `agent1.content` to view the agent's output
* Enter a test message: "John is a software engineer from San Francisco who studied Computer Science at Stanford University."
* Click **Send** to execute the workflow

The agent will analyze the person and return structured information.

[Video: started-4.mp4](https://d4h6f8f5tksdw.cloudfront.net/getting-started/started-4.mp4)

**Configure structured output**

Configure your agent to return structured JSON data. Click on the Agent block to select it.

In the **Response Format** section:

* Click the **magic wand icon** (✨) next to the schema field
* Enter the prompt: "create a schema named person, that contains location, profession, and education"
* The AI will automatically generate the JSON schema

[Video: started-5.mp4](https://d4h6f8f5tksdw.cloudfront.net/getting-started/started-5.mp4)

**Test with structured output**

Return to the **Chat panel** to test the structured response format.

With the response format configured, new output options are now available:

* Click the **Outputs** dropdown and select the structured output option (the schema you just created)
* Enter a test message: "Sarah is a marketing manager from New York who has an MBA from Harvard Business School."
* Click **Send** to execute the workflow

The agent will now return structured JSON output with the person's information organized into location, profession, and education fields.

[Video: started-6.mp4](https://d4h6f8f5tksdw.cloudfront.net/getting-started/started-6.mp4)

## What You've Built

You've successfully created an AI workflow that:

* ✅ Accepts user input through a chat interface
* ✅ Processes unstructured text using AI
* ✅ Integrates external search tools (Exa and Linkup)
* ✅ Returns structured JSON data with AI-generated schemas
* ✅ Demonstrates real-time testing and iteration
* ✅ Showcases the power of visual, no-code development

## Key Concepts You Learned

### Block Types Used

- Start Block

- Agent Block

### Core Workflow Concepts

**Data Flow**\
Connect blocks by dragging connections to pass data between workflow steps

**Chat Interface**\
Test workflows in real-time with the chat panel and select different output options

**Tool Integration**\
Extend agent capabilities by integrating external services like Exa and Linkup

**Variable References**\
Access block outputs using the `<blockName.output>` syntax

**Structured Output**\
Define JSON schemas to ensure consistent, formatted responses from AI

**AI-Generated Schemas**\
Use the magic wand (✨) to generate schemas from natural language prompts

**Iterative Development**\
Build, test, and refine workflows quickly with immediate feedback

## Next Steps

[Explore Workflow Blocks](/blocks)

Discover API, Function, Condition, and other workflow blocks

[Browse Integrations](/tools)

Connect 180+ services including Gmail, Slack, Notion, and more

[Add Custom Logic](/blocks/function)

Write custom functions for advanced data processing

[Deploy Your Workflow](/execution)

Make your workflow accessible via REST API or webhooks

[Build a Frontend](/frontend-launch-kit)

Export your deployed workflows into a Next.js frontend launch kit

## Resources

**Need detailed explanations?** Visit the [Blocks documentation](/blocks) for comprehensive guides on each component.

**Looking for integrations?** Explore the [Tools documentation](/tools) to discover 1,000+ tools and integrations.

**Ready to go live?** Learn about [Execution and Deployment](/execution) to make your workflows production-ready.

**Want a guided course?** Take [SteelEngine Foundations](https://app.steelengine.com/academy), a six-module Academy course (about 75 minutes). It has hands-on exercises on the canvas and a certificate at the end.

## Common Questions

**How long does the getting started tutorial take?**

About 10 minutes. The tutorial walks you through creating a people research agent with web search tools and structured output. You will have a fully working workflow by the end.

**Do I need API keys to follow this tutorial?**

You need API keys for the search tools (Exa and Linkup) used in this tutorial. For the AI model, you can either use SteelEngine's hosted keys (included with your plan credits) or bring your own OpenAI API key. If you prefer not to set up search tool keys, you can still build a basic agent workflow without them.

**Do I need coding experience to complete this tutorial?**

No. The entire tutorial uses the visual drag-and-drop interface. You will connect blocks, configure settings, and test through the chat panel without writing any code.

**Can I use a different AI model instead of GPT-4o?**

Yes. The Agent block supports models from OpenAI, Anthropic, Google, Groq, Cerebras, DeepSeek, Mistral, xAI, and more. You can select any available model from the dropdown. If you self-host, you can also use local models through Ollama.

**Can I import workflows from other tools?**

SteelEngine does not currently support importing workflows from other automation platforms. However, you can use Chat to describe what you want in natural language and have it build the workflow for you, which is often faster than manual recreation.

**What if my workflow does not produce the expected output?**

Use the Chat panel to test iteratively and inspect outputs from each block. You can click the dropdown to view different block outputs and pinpoint where the issue is. The execution logs (open the Logs page from the sidebar, or press Mod+L) show detailed information about each step including token usage, costs, and any errors.

**Where do I go after completing this tutorial?**

Explore the Blocks documentation to learn about Condition, Router, Function, and API blocks. Browse the Tools section to discover 1,000+ tools and integrations you can add to your agents. When you are ready to deploy, check the Execution docs for REST API, webhook, and scheduled trigger options.
