Skip to Content
🎉 Welcome to handit.ai Documentation!
Setting up your autonomous engineer

Set Up Your Autonomous Engineer

Stop being your AI’s on-call engineer. Your autonomous engineer monitors your AI 24/7, detects issues, creates fixes, and ships them as pull requests—automatically.

The Problem: You’re Your AI’s On-Call Engineer

2am failures wake you up. Your AI starts giving bad responses, customers complain, and you’re debugging blind. Did the model change? Is a tool broken? Is there a logic error? Without visibility, you’re playing whack-a-mole with quality issues.

Manual fixes don’t scale. You spot-check responses, find problems, and wonder about the thousands of interactions you didn’t see. By the time you notice issues, they’ve already impacted users.

Your autonomous engineer solves this by monitoring every interaction, detecting quality drops, analyzing root causes, and shipping proven fixes—all automatically.

The Solution: Your Autonomous Engineer

🔍 Monitors your AI interactions and detects quality issues
🛠️ Generates fixes and tests them against real data
📝 Creates pull requests with proven improvements

Time required: Under 5 minutes
Prerequisites: Handit.ai Account , Node.js, and admin access to your GitHub repository

Set up your autonomous engineer

Your autonomous engineer setup happens in one seamless flow through the Handit CLI. Here’s what will happen:

Step 1: Install the Handit CLI

terminal
npm install -g @handit.ai/cli

Step 2: Start the Setup Process

Navigate to your AI project directory and run:

terminal
handit-cli setup

The CLI will guide you through connecting your autonomous engineer to your AI system:

đź”§ Initial Connection

  • Connect your Handit.ai account
  • Install the Handit SDK in your project
  • Configure your API key for monitoring

📱 Test Your Connection

  • The CLI will ask you to run your app to verify everything works
  • Your autonomous engineer immediately starts monitoring your AI
  • You’ll see real-time data flowing in your dashboard

Example of code the CLI generates for you:

The CLI adds tracing only to your main agent entry points - the functions that start agent execution:

Python:

# Auto-generated by handit-cli setup from handit_ai import tracing, configure import os configure(HANDIT_API_KEY=os.getenv("HANDIT_API_KEY")) # Tracing added to your main agent function (entry point) @tracing(agent="customer-service-agent") async def process_customer_request(user_message: str): # Your existing agent logic (unchanged) intent = await classify_intent(user_message) # Not traced individually context = await search_knowledge(intent) # Not traced individually response = await generate_response(context) # Not traced individually return response

JavaScript:

// Auto-generated by handit-cli setup import { configure, startTracing, endTracing } from '@handit.ai/handit-ai'; configure({ HANDIT_API_KEY: process.env.HANDIT_API_KEY }); // Tracing added to your main agent function (entry point) export const processCustomerRequest = async (userMessage) => { startTracing({ agent: "customer-service-agent" }); try { // Your existing agent logic (unchanged) const intent = await classifyIntent(userMessage); // Not traced individually const context = await searchKnowledge(intent); // Not traced individually const response = await generateResponse(context); // Not traced individually return response; } finally { endTracing(); } };

Key point: The CLI only adds tracing to your main agent functions, not to every individual function. Everything inside the traced function gets captured automatically.

Your Autonomous Engineer is Now Active

✅ Check your dashboard: Go to dashboard.handit.ai  to see your AI’s baseline metrics.

Dashboard showing real-time tracing data

🛠️ Automatic fixes: As soon as Handit detects your first issue, it will automatically create a pull request with the fix.

PR Fix

How it works:

  • Detects quality issues in your AI responses
  • Analyzes the root cause automatically
  • Generates a fix and tests it against real data
  • Creates a pull request with the proven improvement

🔍 Continuous monitoring: Your AI is monitored 24/7 - when issues are detected, fixes are shipped automatically.

Troubleshooting

❌ CLI command not found?
Install Node.js first: node --version (should show v16+)

❌ “Authentication failed” during setup?
Check your Handit.ai account credentials at dashboard.handit.ai 

❌ No traces appearing in dashboard?
Run handit-cli setup again and verify your API key: echo $HANDIT_API_KEY

Need more help? Discord  | Support

Last updated on