README.md

metadata

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.