Skip to main content
Agent Lab

Explore, code, and export a Hedera AI Agent.

Agent Builder

Quick no-code configuration for your Hedera AI Agent.

​
Overview

Agent Lab is an interactive development environment within the Hedera Developer Portal for visually designing, building, and testing AI agents powered by the Hedera Agent Kit. It is accessible on the Hedera Portal under the Agent Lab tab. Agent Lab Overview Agent Lab provides a guided path from no-code experimentation to exporting your agent code, enabling developers to prototype quickly and providing a working starting point they can customize and deploy. The tool provides different ways to build and interact with the agent:
  • Use the Agent Builder to configure your agent with no code.
  • Low-Code Mode provides Agent Mode, Framework, and Plugin selection buttons that enable you to choose and configure the basics for your Hedera Agent as the code is built for you.
  • The Advanced Mode toggle enables you to edit the code directly, with the help of an AI Assistant on the right-hand side.
  • Run your agent in the terminal at the bottom of the screen, or interact with the Run Agent to get a preview of what your Hedera Agent will look like for end users.
Agent Lab Overview

​
The Three-Step Workflow

Agent Lab organizes agent development into three sequential steps: Build → Code → Run.
StepDescription
BuildNo-code wizard to configure your agent type, framework, and behavior mode
CodeInteractive low-code editor to inspect, extend, and customize the generated agent code by selecting your framework, mode, and plugins
RunChat interface for executing your agent against Hedera Testnet
You can move between these steps at any time. Clicking Open Chat from the code view opens the Run interface; clicking Close Builder returns you to the code.

​
Quickstart

You can start directly with agent code by visiting the Hedera Portal and clicking on the Agent Lab tab, or use the button at the top of the page to start with the Agent Builder.
There are two AI models at work in Agent Lab:
  • The AI coding assistant (right panel in the code editor) helps you write and extend Hedera Agent Kit code.
  • The agent you build is the Hedera AI agent that executes on-chain transactions when you interact with it when you run the agent, in the terminal.

​
Step 1: Build — Agent Builder Wizard

When you first open Agent Lab (or click Close Builder), a no-code wizard walks you through three configuration choices. Agent Builder Here you can choose:
  • Agent Type - Choose a basic template agent with different features and functionality
  • Framework - Choose the framework you want to use for your agent to handle tools, execution, prompts & memory, and execution patterns.
  • Agent Mode - Choose how your agent operates and interprets prompts Autonomous Mode or Human-in-the-Loop Mode. With human-in-the-loop mode, users will have to sign every transction before execution, and if you are building an agentic application, you will need to integrate with a wallet.

​
Step 2: Code — The Code Editor

The code editor is the central workspace in Agent Lab. It opens automatically after the wizard, or directly when you click the Agent Lab tab. Within the code editor, you can build your agent in different ways, chat with your agent when you run it in the terminal below, switch to Advanced Mode, switch to Chat and Agent Builder views, and Download your agent code. Agent Coding The code editor has three panels:
  • Left sidebar — Toggle plugins, frameworks, and agent controls
  • Center panel — The Monaco-based code editor (the same engine that powers VS Code) showing your generated TypeScript agent code
  • Right panel — The AI coding assistant (available in Advanced Mode)
Below the center panel is a Terminal showing the agent chat, compilation results and agent runtime logs.

​
Block Mode and Advanced Mode

By default, the editor opens in Block Mode. You can switch to Advanced Mode using the toggle in the toolbar.
Agent Lab
Agent Lab
Block Mode is for users who want to configure their agent visually without editing code. In this mode, the left sidebar controls generate and update the agent code automatically. You cannot type directly in the code editor. Any change to the sidebar — adding a plugin, switching frameworks, toggling a control — regenerates the code. Advanced Mode enables direct code editing. When you switch to Advanced Mode, a dialog warns you that:
  • The left-panel form controls will be hidden
  • Manual code changes won’t sync back if you choose to switch back to Block Mode
The AI coding assistant in the right panel is only available in Advanced Mode. Use it to extend your agent with custom logic, ask questions about the Hedera Agent Kit, or debug issues.

​
Step 3: Chat — Agent Chat Interface

The Run view is the chat interface for interacting with the agent you built. It executes your agent code against Hedera Testnet in real time.

​
Accessing the Chat View

  • Click Open Chat in the left sidebar of the code editor
  • If your code compiles cleanly, you’ll enter the chat interface directly
  • If there is a runtime error in your code, a modal will appear before you enter the chat view
Agent Chat

​
Chatting with Your Agent

The chat interface shows a greeting and a text input at the bottom. Type any natural language request to execute queries and transactions on Hedera Testnet:
  • “Create a new Hedera account”
  • “Check my account balance”
  • “Create a fungible token called MyToken”
  • “Send 10 Hbar to account 0.0.123456”
Agent Chat The agent processes your request and executes the corresponding Hedera operations using the plugins configured in your agent. Response messages appear in the chat, reflecting the agent’s tool calls and results.

​
Transaction Approval (Human-In-The-Loop Mode)

If your agent was configured in Human-In-The-Loop mode, transactions are returned as unsigned bytes rather than executed automatically. A Transaction Approval modal will appear showing:
  • Transaction ID
  • Transaction type and details (e.g., recipient, amount, memo)
  • Max fee
  • Raw bytes (expandable)
You can Sign & Execute to submit the transaction using your Developer Portal account credentials, or Reject to cancel it. Successful transactions display a link to HashScan for verification. Human in the Loop Transaction

​
Step 4: Download and Test Your Agent

Once you are done prototyping, you can export your agent code to test it locally or integrate it into your own applications. When you’re ready to test your agent locally, click the Download button in the top right corner of the chat interface. Human in the Loop Transaction This will download a zip file containing your agent code and dependencies. Simply run npm install and npm start to test your agent locally. The README file in the downloaded package provides detailed instructions, and even provides information if you choose to try your agent out on Mainnet.
Agents exported from Advanced Mode will need additional configuration. Please follow the steps provided in the README.md you can find if the .zip export.