Skip to content

AI Startup

app/config/ai.json starts the app's ask, chat, and workflow behavior.

Use it for:

  • the ask-mode system prompt
  • initial ask context variables
  • the chat startup mode
  • the default workflow entry point
  • support widget entry points when the app includes operator support

Minimal Shape

{
  "ask": {
    "ask_mode_prompt": "You help users operate this app.",
    "ask_context_variables": null
  },
  "chat": {
    "chat_startup_mode": "ask"
  },
  "workflows": {
    "entry_point": "ValueEngine"
  }
}

Field Guide

Field Purpose
ask.ask_mode_prompt System prompt for ordinary ask mode. The runtime appends workspace context at call time: app id, user id, the user's current workflow session (from the session router), the current screen's page_context when the client sends it, any host-provided workspace summary from the platform ask_context hook (Studio contributes app-registry counts and recent apps), and the results of the asking page's declared meta.ask_context actions — read-only module actions declared per page in ui/route_manifest.json or page-YAML meta. An action resolves only when its module.yaml opts in with ask_context_safe: true; dispatch runs in enforce mode with an empty permission grant, through the host module-scope resolver.
ask.ask_context_variables Optional default context values for ask mode.
chat.chat_startup_mode Which chat mode opens first, usually ask.
workflows.entry_point Default workflow id when the app launches workflow mode.
support.enabled Enables support surfaces when the app declares support behavior.

app/config/ai.json is startup config. Refinement model profiles live in app/config/refinement_policy.yaml, and refinement routes live under refinement_harness/config/.