Agent API

curl -X POST "https://api.suppio.ai/v1/agents/agent_123/responses" \
  -H "Authorization: Bearer suppio_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "How do I reset my password?"
  }'

import fs from "node:fs";

const endpoint = "https://api.suppio.ai/v1/agents/agent_123/responses";

const tools = [
  {
    type: "function",
    name: "create_ticket",
    description: "Create a support ticket.",
    instructions: "Call when the user needs human follow-up.",
    strict: true,
    parameters: {
      type: "object",
      properties: {
        priority: { type: "string", enum: ["low", "high"] },
      },
      required: ["priority"],
      additionalProperties: false,
    },
  },
];

async function askSuppio(message, imagePath) {
  const attachments = imagePath
    ? [
        {
          type: "image",
          name: "screenshot.png",
          media_type: "image/png",
          data: fs.readFileSync(imagePath, "base64"),
        },
      ]
    : [];

  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.SUPPIO_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ message, attachments, tools }),
  });

  const payload = await response.json().catch(() => null);

  if (!response.ok) {
    const code = payload?.error?.code ?? "unknown_error";
    const detail = payload?.error?.message ?? `Request failed (${response.status})`;
    throw new Error(`${code}: ${detail}`);
  }

  return payload;
}

askSuppio("What does this error mean?", "./screenshot.png")
  .then((payload) => {
    console.log(payload.response);

    for (const action of payload.actions ?? []) {
      if (action.type === "escalate_to_human") {
        console.log("Escalate:", action.reason);
      }
    }

    for (const toolCall of payload.tool_calls ?? []) {
      console.log("Tool call:", toolCall.name, toolCall.arguments);
    }
  })
  .catch((error) => {
    console.error("Suppio API error:", error.message);
  });