Quickstart

1. 1

   Sign up and create an organization

   https://app.humaner.io/auth/signup — under a minute.

2. 2

   Create an agent and add knowledge

   Dashboard, then Agents, then New agent. Paste your site URL, docs, or FAQ. That is what it can answer.

3. 3

   Copy the agent ID

   Dashboard, then Agents, then your agent, then Integrations. You need this for both paths below.

Paste this before </body> on any page. That is the entire integration.

<script
  src="https://app.humaner.ai/widget.js"
  data-agent="ag_demo123"
  data-color="#8B2942"
  data-position="bottom-right">
</script>

Create your API key from /dashboard/settings/API. Then follow the integration process.

const res = await fetch("https://app.humaner.ai/api/v1/chat", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    agentId: "ag_demo123",
    sessionId: crypto.randomUUID(),
    message: "Where is my order?",
  }),
});

// Responses stream as SSE — { delta } chunks

The response streams as Server-Sent Events: a { delta } chunk per token, then one final event with usage, metadata, and handoff. Field-by-field breakdown in the API reference.