自分のドキュメントでサポート質問に答える

const BASE = "https://openapi.felo.ai";
const headers = {
  Authorization: `Bearer ${process.env.FELO_API_KEY}`,
  "Content-Type": "application/json",
};

async function felo<T>(path: string, body?: unknown): Promise<T> {
  const res = await fetch(`${BASE}${path}`, {
    method: body ? "POST" : "GET",
    headers,
    body: body ? JSON.stringify(body) : undefined,
  });
  if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
  return res.json() as Promise<T>;
}

type LiveDocData = { data: { short_id: string } };

const kb = await felo<LiveDocData>("/v2/livedocs", {
  name: "Support knowledge base",
  description: "Help center, policy pages, and internal runbooks",
});

const kbId = kb.data.short_id; // save this in your config

type UrlResult = {
  data: {
    url: string;
    status: string;
    fail_reason: string | null;
    resource_id: string | null;
  }[];
};

const added = await felo<UrlResult>(
  `/v2/livedocs/${kbId}/resources/urls`,
  {
    urls: [
      "https://example.com/help/getting-started",
      { url: "https://example.com/help/billing", title: "Billing FAQ" },
    ],
  },
);

const failed = added.data.filter((item) => item.status === "failed");

type ResourceData = { data: { id: string } };

const runbook = `# Refund policy

Refunds are available within 30 days of purchase. Requests after 30 days
need a manual review by the billing team.
`;

const policy = await felo<ResourceData>(
  `/v2/livedocs/${kbId}/resources/doc`,
  { title: "Refund policy", content: runbook },
);

console.log(policy.data.id); // use this for updates

type Hit = { id: string; title: string; content: string; score: number };

async function findEvidence(question: string) {
  const res = await felo<{ data: Hit[] }>(
    `/v2/livedocs/${kbId}/resources/retrieve`,
    { query: question },
  );
  return res.data.filter((hit) => hit.score >= 0.7).slice(0, 4);
}

const question = "Can I get a refund after 45 days?";
const hits = await findEvidence(question);

type Completion = {
  choices: { message: { content: string | null } }[];
  usage: { prompt_tokens: number; completion_tokens: number; total_tokens: number };
};

const context = hits
  .map((hit) => `### ${hit.title}\n${hit.content}`)
  .join("\n\n");

const completion = await felo<Completion>("/api/v1/chat/completions", {
  model: "anthropic/claude-haiku-5.5",
  messages: [
    {
      role: "system",
      content:
        "Answer only from the context. If the context does not cover the question, say so and hand the ticket to a human.",
    },
    {
      role: "user",
      content: `Context:\n${context}\n\nQuestion: ${question}`,
    },
  ],
});

console.log(completion.choices[0].message.content);
console.log(completion.usage.total_tokens);