- contact@insightserviceai.com
Configuration, the data it reads and the API behind every screen.
A Python (FastAPI) API, a React app and PostgreSQL. InsightService reads the firm’s systems from a source schema and keeps its inbox, cases, replies, remediations, requests, decisions and agent runs in its own schema.
Point SERVICE_SOURCE_SCHEMA at your contacts, customers, accounts, fees, knowledge base and prior complaints, or at views over them.
Replace the illustrative clock, interest rate, threshold and sampling values with your own, and publish the case controls in Rules Studio.
Service agents, team leads and administrators, through the identity service or your SSO.
Set in the environment of the API. Every policy value is a placeholder until you set it.
| Variable | What it sets |
|---|---|
INSIGHT_DATABASE_URL, INSIGHT_DATABASE_SECRET, INSIGHT_DATABASE_SCHEMA | The PostgreSQL connection (or a secret reference for it) and the schema InsightService keeps its own work in (service by default) |
SERVICE_SOURCE_SCHEMA | The schema holding the firm’s systems: customers, accounts, fees, transactions, contacts, the knowledge base and prior complaints. Read only |
SERVICE_ACK_DAYS, SERVICE_FINAL_WEEKS, SERVICE_DUE_SOON_DAYS | The complaint clock: acknowledge within days, final response within weeks, “due soon” days before (defaults 5, 8, 7; illustrative) |
SERVICE_REMEDIATION_RATE, SERVICE_APPROVAL_THRESHOLD | Annual simple interest added to a refund, and the total above which a team lead approves (defaults 0.08 and 250 GBP; illustrative) |
SERVICE_QA_SAMPLE_RATE, SERVICE_SYSTEMIC_CUSTOMERS | The share of closed cases sampled for QA, and the customer count behind the rising-cause systemic test (defaults 0.2 and 5; illustrative) |
SERVICE_AGENTS_LLM, SERVICE_COPILOT_LLM, SERVICE_CLAUDE_MODEL | Whether the agents and the copilot use a language model, and which; 0 means rules only |
SERVICE_AGENTS_MAX_LEVEL | An autonomy ceiling for the tenant; actions are hard-capped at L2 regardless |
SERVICE_COMMS_LIVE, SERVICE_APP_URL | Whether sending a reply or request delivers it, and the address the customer’s request link points to |
SERVICE_ALLOW_TEMPLATE_SEND | Set to 0 to refuse sending a final letter that still contains template wording |
SERVICE_CORS_ORIGINS | The web origins allowed to call the API (* is never honoured) |
The demo builds these tables for a fictional bank and insurer; a deployment maps them to the firm’s systems.
| Source table | What it holds |
|---|---|
firm_profile, products | The firm and its products, each with a product line |
customers | Customers, their contact preferences and any vulnerability already on record |
accounts, fees, transactions | Accounts and policies, fees by fee run, and transactions |
contacts | Inbound emails, web forms, chat transcripts and call notes, with threads |
kb_articles | The knowledge base replies are grounded in |
prior_complaints | Complaints handled before InsightService, with outcome and root cause |
Authenticated with the session’s bearer token; the customer request page and the health checks are the only public routes.
| Area | Endpoints (under /api/service) |
|---|---|
| Reference | GET /reference |
| Inbox | GET /inbox, POST /inbox/sync, GET /inbox/{id}, POST /inbox/{id}/classify, POST /inbox/{id}/case |
| Cases | GET /cases, GET /cases/{id}, PUT /cases/{id}/owner, GET /cases/{id}/timeline, POST /cases/{id}/classify, POST /cases/{id}/research, GET /cases/{id}/customer, POST /cases/{id}/root-causes, POST /cases/{id}/vulnerability, POST /cases/{id}/outcome |
| Remediation | POST /cases/{id}/remediation/calculate, POST /cases/{id}/remediation, GET /cases/{id}/remediations, POST /remediations/{id}/submit, POST /remediations/{id}/decide, GET /remediations |
| Replies | GET|POST /cases/{id}/replies, PUT /replies/{id}, POST /replies/{id}/send, POST /replies/{id}/cancel |
| Requests | GET|POST /cases/{id}/requests, PUT /requests/{id}, POST /requests/{id}/send, POST /requests/{id}/cancel; the customer’s page uses GET|POST /api/public/request/{token} |
| Close | POST /cases/{id}/submit, POST /cases/{id}/close, GET /cases/{id}/decision |
| Knowledge base | GET /kb, GET /kb/{article_id} |
| Oversight | GET /root-causes, GET /root-causes/analytics, POST /root-causes/analyse, POST /root-causes/{id}/acknowledge, GET /qa, POST /qa/sample, POST /qa/{id} |
Agents (under /api/service_agents) | POST /cases/{id}/run, GET /cases/{id}, POST|GET /portfolio/{which}, GET /prepared, POST /prepared/{id}/answer, GET /autonomy, PUT /autonomy/{agent}/level, PUT /autonomy/{agent}/enabled, GET /activity, GET /metrics |
| Rules, home and health | Rules Studio under /api/service_rules; GET /api/me, the home under /api; GET /api/health, GET /api/ready; the copilot under /api/assist, /api/chat and /api/conversation |