An AI-powered support agent for Slack, built with Next.js, Claude (claude-sonnet-4-20250514), and Upstash Redis, deployed on Vercel.

Slack (Events API)
  │
  ▼
Webhook handler ─── Rate limiter (Upstash Redis)
  │
  ▼
Claude AI Agent
  ├── System prompt (persona + rules)
  ├── Tool: search knowledge base
  ├── Tool: review GitHub pull request
  └── Tool: escalate to human
  │
  ▼
Storage
  ├── Conversation DB (Upstash Redis)
  ├── Knowledge base (built-in articles)
  └── Ticket system (extensible)

• Slack integration — responds to @mentions and direct messages
• Claude AI — claude-sonnet-4-20250514 with tool use for RAG, PR review, and escalation
• PR review — share a GitHub PR link and get a structured code review with severity-grouped findings
• Knowledge base — built-in articles for FAQ, billing, API, security, troubleshooting
• Conversation memory — thread-aware history persisted in Redis
• Rate limiting — sliding window limiter to protect API costs
• Signature verification — validates Slack request signatures
• Background processing — acknowledges Slack instantly, processes via waitUntil

git clone https://github.com/nguyenhappy92/happy-agent.git
cd happy-agent
npm install

cp .env.example .env.local

Fill in the values:

npm run dev

Use ngrok to expose localhost for Slack:

ngrok http 3000

Set your Slack Event Subscription URL to https://<ngrok-id>.ngrok.io/api/slack/events.

npx vercel --prod

Or push to GitHub and import the repo at vercel.com/new.

1. Go to api.slack.com/apps → Create New App → From scratch
2. Under OAuth & Permissions, add these Bot Token Scopes:
   • app_mentions:read
   • chat:write
   • im:history
   • reactions:write
3. Under Event Subscriptions:
   • Enable events
   • Set Request URL to https://your-domain.vercel.app/api/slack/events
   • Subscribe to bot events: app_mention, message.im
4. Install the app to your workspace
5. Copy the Bot User OAuth Token → SLACK_BOT_TOKEN
6. Copy the Signing Secret from Basic Information → SLACK_SIGNING_SECRET

Edit src/lib/knowledge/articles.ts to add or modify articles. Each article has:

{
  id: "unique-id",
  title: "Article Title",
  tags: ["keyword1", "keyword2"],
  content: `Markdown content...`
}

The search function matches user queries against titles, tags, and content using keyword scoring.

1. Create a GitHub App at github.com/settings/apps/new
2. Set Repository permissions: Pull requests (Read), Contents (Read), Metadata (Read)
3. Disable webhooks (not needed)
4. Generate a private key (.pem file) from the app settings
5. Install the app on your account/org
6. Add these env vars:
   • GITHUB_APP_ID — from the app settings page
   • GITHUB_APP_PRIVATE_KEY — PEM contents with newlines replaced by \n
   • GITHUB_APP_INSTALLATION_ID — from the installation URL (github.com/settings/installations/{id})

Create a token at github.com/settings/tokens with repo scope and set GITHUB_TOKEN.

In Slack, just say:

@Happy Support review https://github.com/owner/repo/pull/123

The bot will fetch the PR diff and provide a structured review covering:

• Summary of what the PR does
• What's good — positive patterns and clean code
• Issues & suggestions — grouped by severity (Critical / Important / Suggestion)
• Verdict — Approve, Request Changes, or Needs Discussion

The escalate_to_human tool in src/lib/ai/tools.ts currently logs escalations to the console. To integrate with Jira, Freshdesk, or another system, add your API call in the escalate_to_human case:

case "escalate_to_human": {
  // Add your ticket system API call here
  await createJiraTicket({ summary, priority, description: reason });
  // ...
}

For production knowledge bases, replace the keyword search in src/lib/knowledge/search.ts with a vector database (Pinecone, Weaviate, Upstash Vector) for semantic search.

src/
├── app/
│   ├── api/slack/events/route.ts   # Slack webhook handler
│   ├── layout.tsx                  # Root layout
│   ├── page.tsx                    # Landing / status page
│   └── globals.css                 # Styles
└── lib/
    ├── ai/
    │   ├── agent.ts                # Claude orchestrator with tool loop
    │   ├── system-prompt.ts        # Agent persona and rules
    │   └── tools.ts                # Tool definitions + handlers
    ├── github/
    │   └── client.ts               # GitHub API client for PR review
    ├── knowledge/
    │   ├── articles.ts             # Knowledge base content
    │   └── search.ts               # Keyword search engine
    ├── slack/
    │   ├── client.ts               # Slack Web API wrapper
    │   └── verify.ts               # Request signature verification
    └── storage/
        ├── redis.ts                # Upstash Redis client
        ├── conversations.ts        # Thread history store
        └── rate-limiter.ts         # Sliding window rate limiter

MIT