چت‌بات مستندات

const BASE = "https://api.daneshyar.info/api/v1";
const KEY = process.env.DANESHYAR_API_KEY;

const WORKSPACE = "8f14e45f-ceea-467a-9f4c-1a2b3c4d5e6f";

/**
 * Answer questions about your own docs, and link each source back to the page
 * it came from. The trick is keeping your own slug in the resource title, so a
 * citation can be turned back into a URL without a second lookup.
 */
export async function answerDocsQuestion({ visitorId, question }) {
  const res = await fetch(`${BASE}/workspaces/${WORKSPACE}/chat/`, {
    method: "POST",
    headers: { "X-API-Key": KEY, "Content-Type": "application/json" },
    body: JSON.stringify({
      external_user_id: visitorId,
      message: question,
    }),
  });

  const { data } = await res.json();
  const reply = data.assistant_message;

  // response.parts attaches each source to the span it supports — use it when
  // you want footnotes rather than a flat list under the answer.
  const footnotes = reply.response.parts
    .filter((part) => part.source)
    .map((part) => ({
      text: part.text,
      title: part.source.resource_title,
      // metadata carries the position: page for a PDF, start_time for audio.
      page: part.source.metadata?.page ?? null,
      href: `/docs/${slugFromTitle(part.source.resource_title)}`,
    }));

  return { answer: reply.content, footnotes };
}

function slugFromTitle(title) {
  return title.replace(/\.[^.]+$/, "").toLowerCase().replace(/\s+/g, "-");
}