Skip to main content

Execution Profiles

AICOS v2 introduces conversation-type-aware execution profiles that replace the one-size-fits-all execution model. Instead of running the same pipeline for every trigger, AICOS now automatically selects an optimized profile based on what kind of work it is doing, resulting in faster responses, lower costs, and better quality.

How Execution Profiles Work

When AICOS receives a trigger (a scheduled wake-up, a chat message, an inbound email, or an event notification), it resolves the trigger to one of six execution profiles. The profile controls every dimension of the pipeline:

  • Resource budgets - Execution time and token allocation. There is no tool-call cap; executions are governed by your tenant's cost limits and the platform's 30-minute host timeout
  • Model selection - Which LLM to use (primary or chat-optimized)
  • System prompt - How much context to include (full, standard, compact, or minimal)
  • Tool subset - Which tools are available for this conversation type
  • Phase configuration - Which pre-execution steps run (some are skipped for fast responses)
  • Temperature - Tuned per phase for optimal output quality
  • Streaming - Whether tokens are delivered in real time

Profile resolution happens once at the start of execution, before any LLM calls. The resolved profile drives all downstream parameters. If resolution fails for any reason, AICOS falls back to the full pipeline (v1 behavior), ensuring no disruption.

Trigger Arrives
|
v
Resolve Profile (from trigger type)
|
v
Configure Pipeline
|---> Resource budgets (max time, max tokens; no tool-call cap)
|---> Model selection (primary or chat)
|---> System prompt tier (full, standard, compact, minimal)
|---> Tool subset (all, email-focused, chat-focused, event-focused)
|---> Phase skipping (skip unnecessary pre-work for fast paths)
|---> Temperature and streaming settings
|
v
Execute via Core Loop
(same proven engine, different parameters)

The Six Profiles

Long Processing (long_processing)

The daily workhorse profile. Used for scheduled wake-ups, manual triggers, and goal assignments where AICOS needs to review all goals, plan projects, execute tasks, coordinate SMEs, and record knowledge.

ParameterValue
Tool-call capNone
Max execution time20 minutes
Max tokens per response16,384
System promptFull (all 15 sections)
Tools availableAll tools
StreamingNo
ModelPrimary

When it activates:

TriggerDescription
scheduled_wakeupDaily scheduled wake-up
manual_triggerAdministrator-initiated from dashboard
daily_wakeupLegacy daily trigger
wake_upGeneric wake-up
goal_assignedNew goal assigned
goal_updatedExisting goal modified

What happens: AICOS runs all phases, including knowledge bootstrapping, context assessment, reflection on prior sessions, delta calculation, goal decomposition, session planning, execution, communication, and scheduling. This profile benefits from prompt caching since the system prompt remains stable across many LLM calls within a single execution. Progressive compaction preserves recent tool results while summarizing older conversation turns to maximize the useful context window.

Email Research (email_research)

Mid-weight profile for processing inbound emails and email replies. Focuses on email-related tools and skips planning-heavy phases that are not relevant to email handling.

ParameterValue
Tool-call capNone
Max execution time10 minutes
Max tokens per response8,192
System promptStandard (8-10 sections)
Tools availableEmail and research tools
StreamingNo
ModelPrimary

When it activates:

TriggerDescription
email_inboundNew inbound email received
email_replyReply to an existing email thread

What happens: AICOS loads email context (sender, thread, body), retrieves relevant knowledge, and drafts a response. It skips reflection, delta calculation, and goal decomposition since these are not needed for email handling. Temperature is tuned for factual accuracy during research and allows slightly more creativity during synthesis. The tool subset includes email composition, knowledge retrieval, web search, and SME delegation, but excludes project management and goal tools.

Available tools in this profile:

  • respond, send_to, forward_email
  • retrieve_knowledge, record_knowledge, search_outermind_docs
  • send_message_to_bo
  • sme_<name> (per-SME, generated automatically for each SME the agent is granted)
  • tool_search

Quick Chat (quick_chat)

The fast path, optimized for conversational latency. Business Owner messages, Teams mentions, and Slack mentions are routed here for sub-second first-token delivery.

ParameterValue
Tool-call capNone
Max execution time3 minutes
Max tokens per response4,096
System promptCompact (4-5 sections)
Tools availableChat-relevant tools (read-only + messaging)
StreamingYes (tokens arrive in real time)
ModelChat (faster, lower-latency model if configured)

When it activates:

TriggerDescription
bo_messageBusiness Owner sends a chat message
teams_messageMessage via Microsoft Teams
slack_messageMessage via Slack

What happens: AICOS skips all pre-phases (knowledge bootstrapping, reflection, delta calculation, goal decomposition) and jumps directly to the core execution loop with a compact system prompt. The minimal prompt includes base instructions, key people, and a lightweight context summary, omitting phase instructions, operational context, and pre-fetched knowledge bundles. Tokens stream to the frontend via SignalR so the user sees the response building in real time. If the LLM responds without tool calls, the loop terminates immediately rather than continuing to iterate.

Available tools in this profile:

  • retrieve_knowledge, record_knowledge
  • send_message_to_bo, respond
  • search_outermind_docs
  • summarize_active_work, review_project, review_goal
  • tool_search
tip

Configure a dedicated chat model in AICOS Settings for the best quick chat experience. A faster model (such as Claude Sonnet 4) delivers noticeably quicker responses for simple status questions and conversations, while the primary model (such as Claude Opus 4.5) handles deep planning during daily wake-ups.

Reactive Event (reactive_event)

Event-driven profile for handling completions, approvals, and reminders. Loads minimal context, focuses on processing the event and updating state.

ParameterValue
Tool-call capNone
Max execution time5 minutes
Max tokens per response8,192
System promptMinimal (essential instructions only)
Tools availableEvent-focused tools (status updates + communication)
StreamingNo
ModelPrimary

When it activates:

TriggerDescription
approval_receivedBusiness Owner approved or denied a request
reminder_triggeredA scheduled reminder fired
sme_completedAn SME agent completed its delegated task
scheduled_followupA scheduled follow-up action triggered

What happens: AICOS loads the event context, assesses what happened, updates the relevant project or task state, and optionally notifies the Business Owner. It does not need planning, reflection, or goal decomposition, since the event itself defines the scope of work. The tool subset includes state update tools (update project, update task, complete task), communication tools, and knowledge tools.

Available tools in this profile:

  • update_project, update_project_tasks, complete_project_tasks
  • update_goal
  • record_knowledge, retrieve_knowledge
  • send_message_to_bo, administer_approvals
  • manage_my_settings (setting_area=scheduled_reminders)
  • sme_<name> (per-SME, generated automatically for each SME the agent is granted)
  • tool_search

Process Email Inbound (process_email_inbound)

PA-specific profile for processing new emails arriving in a Personal Assistant's shared mailbox. Lighter than AICOS's email_research profile since PA focuses on reply/notify/read actions rather than deep research.

ParameterValue
Tool-call capNone
Max execution time5 minutes
Max tokens per response8,192
System promptStandard
Tools availablePA inbound email tools (reply, forward, calendar, mailbox search)
StreamingNo
ModelPrimary

When it activates:

TriggerDescription
pa_email_inboundNew email received in a PA shared mailbox

What happens: The PA loads the email context, determines if a reply is needed or if the employee should be notified, and takes appropriate action. When the email is from someone other than the employee it supports, it does not initiate autonomous project or task work from the email. When the sender is the employee themselves (verified by the platform, not by the message), the PA carries out what they asked under its normal approval, autonomy and policy gates, and raises an approval request rather than refusing if the request exceeds its autonomy level. The tool subset includes email composition, knowledge retrieval, employee inbox/calendar access, and mailbox search.

Available tools in this profile:

  • respond, forward_email
  • retrieve_knowledge, search_outermind_docs
  • send_message_to_boss
  • read_my_inbox, read_supervisor_calendar
  • search_other_mailboxes, list_email_attachments, extract_attachment_text

Process Email Reply (process_email_reply)

PA-specific profile for processing replies to emails previously sent by the PA. Slightly larger budget than inbound since replies may require updating tasks or recording knowledge.

ParameterValue
Tool-call capNone
Max execution time8 minutes
Max tokens per response8,192
System promptStandard
Tools availablePA reply tools (inbound tools + task updates + knowledge recording)
StreamingNo
ModelPrimary

When it activates:

TriggerDescription
pa_email_replyReply received to a PA-sent email

What happens: The PA continues the email conversation based on the reply content. It may update tasks or record knowledge based on information in the reply. If the reply resolves an open question, the PA updates the relevant records. The tool subset extends inbound tools with write capabilities for tasks and knowledge.

Available tools in this profile:

  • respond, forward_email
  • retrieve_knowledge, search_outermind_docs, record_knowledge
  • send_message_to_boss
  • read_my_inbox, read_supervisor_calendar
  • search_other_mailboxes, list_email_attachments, extract_attachment_text
  • complete_project_tasks, update_project_tasks

Profile Comparison

DimensionLong ProcessingEmail ResearchQuick ChatProcess Email InboundProcess Email ReplyReactive Event
Typical duration5-20 minutes1-5 minutes2-15 seconds30 seconds - 3 minutes1-5 minutes30 seconds - 2 minutes
Tool calls50-100+10-301-55-155-205-15
Tool-call capNoneNoneNoneNoneNoneNone
Max execution time20 minutes10 minutes3 minutes5 minutes8 minutes5 minutes
Max tokens/response16,3848,1924,0968,1928,1928,192
System promptFullStandardCompactStandardStandardMinimal
StreamingNoNoYesNoNoNo
Model tierPrimaryPrimaryChatPrimaryPrimaryPrimary
Phase skippingNoneReflection, deltaAll pre-phasesAll except assessAll except assessReflection, delta, decomposition

Profile Budgets Are Platform-Managed

Profile budgets are set by the platform and are not tenant-configurable. Earlier releases exposed per-tenant, per-profile budget sliders; those controls were removed rather than left as knobs that silently did nothing.

info

There is no tool-call cap on any execution. Executions are governed by your tenant's cost limits and the platform's 30-minute host timeout. The per-profile values in the tables above are reference information only - they are not enforced per tenant and cannot be overridden.

The Workforce > Execution Profiles page shows this same reference information read-only, so you can see which trigger types map to which profile and what prompt/model characteristics each one carries.

The budget control you do own is the optional Daily AI Budget field on the AICOS Settings page, which caps tenant-wide AI spend per day.

What to Do Instead

ScenarioAction
Chat responses are too slowVerify a dedicated chat model is configured; there is no tool-call limit to reduce
Daily runs time out frequentlyReview the Performance dashboard; execution time is bounded by the platform's 30-minute host timeout, not a per-tenant setting
Email research is too shallowReview the Performance dashboard; there is no tool-call cap limiting research depth
Costs are too high for daily runsLower the Daily AI Budget on the AICOS Settings page
Reactive events need more depthThere is no tool-call cap limiting depth; review the Performance dashboard for other bottlenecks

Understanding Phase Skipping

Different profiles skip different pre-execution phases to optimize for their use case. Understanding which phases run helps explain why certain conversation types are faster than others.

Execution Phases

PhaseLong ProcessingEmail ResearchQuick ChatProcess Email InboundProcess Email ReplyReactive Event
Context AssessmentYesYesYesYesYesYes
Knowledge Pre-fetchYesYesSkippedSkippedSkippedSkipped
Load Session StateYesSkippedSkippedSkippedSkippedYes
Delta CalculationYesSkippedSkippedSkippedSkippedSkipped
Reflection on Prior SessionsYesSkippedSkippedSkippedSkippedSkipped
Goal DecompositionYesSkippedSkippedSkippedSkippedSkipped
Session PlanningYesSkippedSkippedSkippedSkippedSkipped
Execute WorkYesSkippedSkippedSkippedSkippedSkipped
CommunicationYesSkippedSkippedSkippedSkippedSkipped
State SaveYesSkippedSkippedSkippedSkippedYes
Schedule Next RunYesSkippedSkippedSkippedSkippedSkipped

The quick chat and PA email profiles achieve their speed by skipping most pre-phases, going directly from context assessment to the core execution loop. Only long_processing runs the full pipeline.

Fallback Behavior

Execution profiles are designed with backwards compatibility in mind:

  • Unknown trigger types automatically map to long_processing (the full pipeline)
  • If profile resolution fails, the executor falls back to v1 behavior with all default settings
  • If a configured chat model is unavailable, the system falls back to the primary model
  • If a configured chat model becomes inactive, the system falls back to the primary model

This ensures that AICOS never fails due to profile configuration issues. The worst case is that a chat message runs through the full pipeline (slower but still functional).

Troubleshooting

Chat Responses Are Still Slow

  1. Verify that a chat model is configured in AICOS Settings (see Settings & Customization)
  2. Check the Performance dashboard for the quick chat p95 latency metric
  3. Ensure the chat model is active and has available API quota
  4. If using Claude Opus as the chat model, consider switching to Claude Sonnet for faster responses

Profile Resolution Issues

If AICOS appears to be using the wrong profile for a trigger type:

  1. Check the execution logs in Governance > Data & Logs for the profileCategory field
  2. Compare the profileTrigger value against the expected trigger-to-profile mapping above
  3. Unknown trigger types default to long_processing, which is safe but may be slower than expected

Budget Exceeded Errors

There is no tool-call cap on any execution, so an execution is never cut short for making too many tool calls. If executions are timing out:

  1. Review the Performance dashboard to see average tool usage and duration by profile
  2. Consider whether the trigger is being routed to the right profile
  3. Contact support if runs are consistently reaching the platform's 30-minute host timeout - that ceiling is platform-managed and not tenant-configurable

End-User Reasoning Escalation

For chat-style work, end users can opt their next message into the heaviest reasoning model (Opus tier) by starting it with one of the recognized reasoning-request phrases or including an inline marker. This is useful when a user wants a deeper, more careful answer for a specific question without changing any tenant-level configuration. The escalation respects your tenant's subscription tier, so a tier without access to the reasoning model continues to run on the model the tenant was already entitled to.

The recognized triggers are:

  • Phrases at the start of the message (or right after a sentence ending): "think hard", "think carefully", "think step by step", "think this through", "think about it deeply", "be thorough", "deep dive", "in depth" or "in-depth", "extended thinking", "use reasoning", "really think", "no shortcuts".
  • Inline markers that work anywhere in the message: #think, /think, **think**, *think*.

The phrase check is anchored, so a casual mid-sentence "I'll think hard about it later" does not trigger an upgrade; only a leading "Think hard about Q3 positioning" does. Markers are unanchored so users who do not want to craft a sentence can opt in with a single token. Communicate these phrases and markers to your end users so they know how to ask for a deeper response when one is warranted. Each escalation is recorded in the execution logs with the matched substring for audit review.