Quickstart

• Existing traces: connect Braintrust or Langfuse in Settings → Connections. This can import selected trace history and continue syncing according to the connector configuration.
• New events: use the Conversations SDK or MCP wrapper below, or send requests to the ingestion API.

​

Before you start

pip install honeai

npm install @asymmetric-ai/hone

​

Path A — Conversations SDK

import honeai

honeai.init("sk_your_key_here")

interaction = honeai.begin(
    user_id="user_8f21",
    agent_name="support-bot",
    input="How do I reset my password?",
)

# ... run your agent, produce a reply ...
reply = "Head to Settings, then Security, and choose Reset password."

interaction.end(reply, success=True)

import { init, begin } from "@asymmetric-ai/hone";

init("sk_your_key_here");

const interaction = begin({
  userId: "user_8f21",
  agentName: "support-bot",
  input: "How do I reset my password?",
});

// ... run your agent, produce a reply ...
const reply = "Head to Settings, then Security, and choose Reset password.";

interaction.end(reply, { success: true });

​

Path B — MCP server

import honeai.mcp
from mcp.server.fastmcp import FastMCP

server = FastMCP("inventory-tools")

# ... register your tools on `server` ...

honeai.mcp.track(server, api_key="sk_your_key_here")

server.run()

import { trackMCP } from "@asymmetric-ai/hone";
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

const server = new McpServer({ name: "inventory-tools", version: "1.0.0" });

// ... register your tools on `server` ...

trackMCP(server, "sk_your_key_here");

// start the server as usual

​

Verify

1. Trigger one turn (Path A) or call one tool (Path B).
2. Open the Tensile dashboard and go to Raw Logs — your call appears as a row with its operation name, status, latency, and timestamp.
3. Expand the row to inspect the input and output payloads.
4. For Path A, the turn may also appear under User Stories, grouped by the user_id you passed, when that workspace view is enabled for your organization.

​

Where to go next