Adding Annotations to your Spans

#!/usr/bin/env python3
import json, requests

from datetime import datetime
from rich import print as rprint
from rich.console import Console
from rich.table import Table

BASE_URL      = "https://api.futureagi.com"
FI_API_KEY    = "<YOUR_API_KEY>"
FI_SECRET_KEY = "<YOUR_SECRET_KEY>"

console = Console()

def headers():
    return (
        {
            "X-Api-Key": FI_API_KEY,
            "X-Secret-Key": FI_SECRET_KEY,
            "Content-Type": "application/json",
        }
    )

def get_first_label_id():
    resp = requests.get(f"{BASE_URL}/tracer/get-annotation-labels/", headers=headers(), timeout=20)
    resp.raise_for_status()
    label = resp.json()["result"][0]
    console.log(f"Using label: {label['name']} ({label['type']})")
    return label["id"]

def build_payload(span_id, label_id):
    ts = datetime.utcnow().isoformat(timespec="seconds")
    return {
        "records": [
            {
                "observation_span_id": span_id,
                "annotations": [
                    {"annotation_label_id": label_id, "annotator_id": "human_a", "value": "good"},
                    {"annotation_label_id": label_id, "annotator_id": "human_a", "value_float": 4.2},
                ],
                "notes": [{"text": "First note " + ts, "annotator_id": "human_a"}],
            }
        ]
    }

def pretty(resp_json):
    table = Table(title="Bulk-Annotation Result", show_header=True, header_style="bold cyan")
    table.add_column("Key"); table.add_column("Value", overflow="fold")
    for k, v in resp_json.items():
        table.add_row(k, json.dumps(v, indent=2) if isinstance(v, (dict, list)) else str(v))
    console.print(table)

if __name__ == "__main__":
    SPAN_ID  = "<SPAN_ID>"
    payload  = build_payload(SPAN_ID, get_first_label_id())
    rprint({"payload": payload})

    resp = requests.post(f"{BASE_URL}/tracer/bulk-annotation/", headers=headers(), json=payload, timeout=60)
    resp.raise_for_status()
    pretty(resp.json())

#!/usr/bin/env ts-node
import axios from "axios";

const BASE_URL = "https://api.futureagi.com";
const SPAN_ID  = "<SPAN_ID>";

// Choose ONE auth method
const FI_API_KEY  = "<YOUR_API_KEY>";
const FI_SECRET_KEY = "<YOUR_SECRET_KEY>";

// ────────────────────────────

function headers(): Record<string, string> {
    return {
      "X-Api-Key": FI_API_KEY,
      "X-Secret-Key": FI_SECRET_KEY,
      "Content-Type": "application/json",
    };
}

async function getFirstLabelId(): Promise<string> {
  const resp = await axios.get(`${BASE_URL}/tracer/get-annotation-labels/`, {
    headers: headers(),
    timeout: 20000,
  });
  const label = resp.data.result[0];
  console.log(`Using label: ${label.name} (${label.type})`);
  return label.id;
}

function buildPayload(spanId: string, labelId: string) {
  const ts = new Date().toISOString().slice(0, 19);

  const recordNew = {
    observation_span_id: spanId,
    annotations: [
      { annotation_label_id: labelId, annotator_id: "human_annotator_1", value: "good" },
    ],
    notes: [
      { text: "First note " + ts, annotator_id: "human_annotator_1" },
    ],
  };

  return { records: [recordNew] };
}

async function main() {
  try {
    const labelId = await getFirstLabelId();
    const payload  = buildPayload(SPAN_ID, labelId);

    console.log("\n──── REQUEST PAYLOAD ────");
    console.dir(payload, { depth: null });

    const resp = await axios.post(`${BASE_URL}/tracer/bulk-annotation/`, payload, {
      headers: headers(),
      timeout: 60000,
    });

    console.log("\n──── RESPONSE ────");
    console.dir(resp.data, { depth: null });
  } catch (err: any) {
    if (err.response) {
      console.error(`HTTP ${err.response.status}`);
      console.error(err.response.data);
    } else {
      console.error("Error:", err.message);
    }
    process.exit(1);
  }
}

main();

curl -X POST https://api.futureagi.com/tracer/bulk-annotation/ \
-H "X-Api-Key: <YOUR_API_KEY>" \
-H "X-Secret-Key: <YOUR_SECRET_KEY>" \
-H "Content-Type: application/json" \
-d '{"records": [{"observation_span_id": "<SPAN_ID>", "annotations": [{"annotation_label_id": "<LABEL_ID>", "annotator_id": "human_annotator_1", "value": "good"}]}]}'