Prompts & Instructions
Prompts & Instructions (SPI)
Every system prompt and instruction your agent can receive has a stable SPI id. This registry explains each one — who owns it, when it is sent, and its exact text.
Every instruction EgoX sends to the model carries a stable SPI id (System Prompt / Instruction). Ids are banded by ownership:
- SPI_0xx — tenant-editable: your prompts (base / endpoints / knowledge), your personality profile, your tool descriptions.
- SPI_1xx — EgoX-managed policies: fixed safety/behavior blocks appended automatically (retry policy, workspace scope, voice rules…).
- SPI_2xx — internal: instructions used by EgoX pipelines, never part of your agent's prompt.
The debug flow canvas (Console → Threads → Debug) tags every prompt segment with its SPI id — click an id there to land on its page here.
Registry
| ID | Name | Ownership | Sent when |
|---|---|---|---|
SPI_001 | System Prompt (base) | Tenant-editable | Every ask in agentic mode; vanilla intent in classic mode. |
SPI_002 | Endpoints prompt | Tenant-editable | Classic mode, tools intent. |
SPI_003 | Knowledge Base + Endpoints prompt | Tenant-editable | Classic mode, rag_tools intent. |
SPI_004 | Knowledge Base prompt | Tenant-editable | Classic mode, rag intent. |
SPI_005 | Personality block | Tenant-editable | Every ask when the tenant has an active personality profile. |
SPI_006 | Endpoint (tool) descriptions | Tenant-editable | Whenever tools are exposed to the model. |
SPI_101 | Tool retry policy | EgoX-managed policy | Whenever tools are callable (classic tools/rag_tools intents; agentic with any tool or KB). |
SPI_102 | KB search policy | EgoX-managed policy | Agentic mode when the search_knowledge_base tool is exposed. |
SPI_103 | Get-conversation safety policy | EgoX-managed policy | When a getConversation/get_conversation tool is enabled. |
SPI_104 | Workspace scope policy | EgoX-managed policy | When externalThreadId starts with collab:ws: (in-workspace DotCollab). |
SPI_105 | Voice call policy | EgoX-managed policy | When the request arrives with voiceMode (live /egox/call turn). |
SPI_106 | JSON schema instructions | EgoX-managed policy | When responseFormat is json_object and the request carries a jsonSchema. |
SPI_107 | KB search tool description | EgoX-managed policy | Agentic mode with RAG enabled. |
SPI_201 | Compliance classifier prompt | Internal (not part of your agent’s prompt) | Worker process — async compliance audit queue. |
SPI_202 | Conversation title generator | Internal (not part of your agent’s prompt) | First turn of a new thread when Auto-title is on and the tenant is not no-store. |