@inkeep/agents-manage-ui

This is a Next.js project bootstrapped with create-next-app.

Agent Builder

This application provides a UI for building and managing agents. It integrates with the agents-manage-api and agents-run-api backend services to provide full CRUD operations for agent management and real-time chat execution.

Features

• Full Agent API Integration: Complete server actions for creating, reading, updating, and deleting agents
• Type Safety: Full TypeScript support with Zod schema validation
• Server Actions: Next.js server actions for seamless client-server communication
• Error Handling: Comprehensive error handling with proper error codes and messages

Traces Feature

The Agent Builder includes a traces view that displays real-time conversation statistics from your agents. This feature integrates with SigNoz to provide insights into:

• Total conversations in the last 24 hours
• Tool calls per conversation (including MCP tools)
• Agent transfers tracking
• Agent delegations tracking

Setting up SigNoz for Traces

• Run SigNoz locally (if not already running):

  • Ensure SigNoz is accessible at http://localhost:3080

• Create an API key in SigNoz:

  • Navigate to SigNoz UI at http://localhost:3080
  • Go to Settings → API Keys
  • Click New Key and create a new API key
  • Copy the generated API key

• Configure environment variables in your .env.local:

  SIGNOZ_URL=http://localhost:3080
  SIGNOZ_API_KEY=your-api-key-here
  

• Access the Traces view:

  • Start the Agent Builder: pnpm dev
  • Navigate to the Traces section in the sidebar

Configuration

Create a .env.local file with the following configuration:

# Inkeep Configuration
TENANT_ID="default"
INKEEP_AGENTS_MANAGE_API_URL="http://localhost:3002" # URL where agents-manage-api is running
PUBLIC_INKEEP_AGENTS_MANAGE_API_URL=http://localhost:3002 # URL where agents-manage-api is running
PUBLIC_INKEEP_AGENTS_RUN_API_URL="http://localhost:3003" # URL where agents-run-api is running

# SigNoz Configuration (for Traces feature)
SIGNOZ_URL=http://localhost:3080
PUBLIC_SIGNOZ_URL=http://localhost:3080
SIGNOZ_API_KEY=your-signoz-api-key-here

For detailed usage instructions and examples, see the Library Documentation.

Getting Started

Install dependencies

pnpm install

Run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.