Add a cited knowledge agent to your app with the Cortex SDK

import { createCortexHandler, type CortexStore } from "./sdk/server.ts";

const handler = createCortexHandler({
  config: {
    baseUrl: process.env.CORTEX_API_BASE_URL!,
    assistantId: process.env.CORTEX_ASSISTANT_ID!,
    apiKey: process.env.CORTEX_SHARED_API_KEY!, // server secret only
  },
  allowedOrigin: "https://your-app.example",
  authenticate: async (request) => {
    const user = await verifyYourApplicationSession(request);
    return user ? { id: user.id, externalUserId: user.cortexIdentity } : null;
  },
  store: yourStoreAdapter satisfies CortexStore,
});
// Mount at /cortex — Supabase Edge Functions, Deno, Node or Workers.

import { createCortexBrowserClient } from "./sdk/browser.ts";
import { CitedAnswer } from "./sdk/react.ts";

const cortex = createCortexBrowserClient({
  endpoint: "https://your-app.example/cortex",
  fetch: yourAuthenticatedFetch, // the browser never sees the Cortex key
});

const conversationId = await cortex.createConversation(signal);
for await (const update of cortex.ask(conversationId, { message }, signal)) {
  if (update.type === "answer") showPreview(update.answer);
  else reloadSavedAnswer(update.messageId);
}

<CitedAnswer answer={saved.answer} messageId={saved.id}
  authScope={`${backendId}:${tenantId}:${accountId}`} loadPdf={cortex.pdf} />;

const { results } = await cortex.rag({
  query: "What is our refund policy?",
  max_results: 5,
});
// [{ id_element, id_datasource, content, rank, metadata }]

curl -N -X POST \
  "https://agent.uthereal.ai/api/functions/v1/api-server-proxy/external/v1/assistants/$ASSISTANT_ID/sessions/$SESSION_UUID/ask" \
  -H "Authorization: Bearer $CORTEX_SHARED_API_KEY" \
  -H "X-App-Code: selfserve" \
  -H "Content-Type: application/json" \
  -d '{"id_user":"user-123","message":"What does the guide say about onboarding?"}'