---
title: NegOptim AI Service
emoji: 🤖
colorFrom: green
colorTo: blue
sdk: docker
app_port: 7860
pinned: false
---

# NegOptim AI Service

Stateless FastAPI backend for the `negOptimChatExternal` Salesforce LWC. It wraps
Groq and OpenRouter LLMs with a schema-grounded NegOptim catalog, an embedding
router, three Salesforce tools (executed by Apex, not here), a per-query usage
report and a canned-response cache for small talk.

## Endpoints
- `GET /health` — liveness, active models, router mode
- `GET /models` — selectable models (Groq + OpenRouter)
- `GET /usage?model=<id>` — daily usage for the selected model
- `POST /chat` — one agent step (final answer or tool calls for Salesforce)

## Configuration (Space secrets → Settings → Variables and secrets)
- `OPENROUTER_API_KEY` — required for OpenRouter models
- `GROQ_API_KEY` — required for Groq models (preferred)
- `SERVICE_API_KEY` — shared secret; must match the Salesforce custom setting
- `OPENROUTER_MODEL` / `GROQ_MODEL` — optional primary-model overrides

No Salesforce credentials live here — the org calls this service via a Named
Credential, and the LLM's tool requests are executed inside Salesforce.