Custom — Agent Brief

HUMANER_API_KEY=hm_live_xxxxxxxx
HUMANER_AGENT_ID=YOUR_AGENT_PUBLIC_ID
HUMANER_BASE_URL=https://app.humaner.io

const BASE = process.env.HUMANER_BASE_URL!;
const KEY = process.env.HUMANER_API_KEY!;
const AGENT_ID = process.env.HUMANER_AGENT_ID!;

async function call<T>(path: string, body: Record<string, unknown>): Promise<T> {
  const res = await fetch(`${BASE}/api/v1/intelligence/${path}`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({ agentId: AGENT_ID, ...body })
  });

  if (!res.ok) {
    throw new Error(`Humaner ${path} failed: ${res.status}`);
  }

  return res.json() as Promise<T>;
}

export const retrieve = (query: string) =>
  call<{
    chunks: {
      content: string;
      heading: string | null;
      source: string;
      score: number;
    }[];
    grounded: boolean;
    forbiddenTopics: string[];
  }>("retrieve", { query });

export const matchRunbook = (ticketContext: string) =>
  call<{
    matched: boolean;
    runbook: { id: string; title: string | null } | null;
  }>("match-runbook", { ticketContext });

export const createTicket = (input: {
  subject: string;
  visitorEmail: string; // required — collect it before escalating
  transcript: { role: string; content: string }[];
}) =>
  call<{ ticketId: string; ticketNumber: number; routedTo: string }>(
    "create-ticket",
    input
  );

import { createTicket, matchRunbook, retrieve } from "./humaner";

export async function answer(
  message: string,
  visitorEmail: string, // tickets require it — collect it before escalating
  transcript: { role: string; content: string }[]
) {
  // Independent calls: fire both at once.
  const [match, { chunks, grounded, forbiddenTopics }] = await Promise.all([
    matchRunbook(message),
    retrieve(message)
  ]);

  if (!grounded) {
    const ticket = await createTicket({
      subject: message.slice(0, 120),
      visitorEmail,
      transcript
    });
    return `I have passed this to a teammate. Ticket #${ticket.ticketNumber}.`;
  }

  // Your model, your prompt, your voice. The matched runbook names the
  // procedure you wrote in the dashboard; steer the reply toward it.
  return generateReply({
    message,
    context: chunks,
    forbiddenTopics,
    runbookTitle: match.runbook?.title ?? null,
    transcript
  });
}

Never discuss the following topics. Decline politely and offer a ticket:
- Competitor feature comparisons
- Confirming unannounced features or roadmap dates
- Legal or compliance advice