Behavior profiles
The settings on the Behavior Profiles page let you define context-driven overrides for agent conversation behavior. Profiles in addition to any agent baseline when the defined conditions match, but don’t modify the core definition of the agent. Navigation: Project → Settings → Behavior ProfilesCreate a behavior profile
Create profile
Selecting this option opens an editor.
Below the header, the profile editor organizes settings into three behavior sections:
Speaking
Listening
No-input handling configuration
This is only supported for pipeline voice using KoreVG.
Authoring Note: A free-text field for documenting when and why this profile applies.
All settings default to Inherit, meaning the agent’s base configuration applies. Override any setting to customize behavior for the profile’s conditions. Select Save to create the profile, or switch to Raw DSL to edit the profile definition as code.
Alert settings
The Alert Settings page defines rules that trigger notifications when project metrics breach a threshold. The runtime evaluates each rule on a fixed cadence and delivers a notification by email or webhook when the condition matches. Navigation: Project → Settings → Alert Settings When the project has no rules yet, the page shows an empty state. Select Create alert rule to open the rule editor, or Browse available metrics to review every metric the evaluator can alert on before you start. Typical uses include containment rate drops, error spikes, latency increases, and sentiment degradation.Create an alert rule
Select Create alert rule to open the Create alert rule panel. The footer tracks what the rule still needs (for example,Still needed: name, metric, recipients) and keeps Save rule available once you supply those values. Select Cancel to discard the rule.
If Deliver via : Email:
If Deliver via : Webhook:
Subject scopes
Available metrics
Agent and LLM metrics
The Agent and LLM tabs list the same LLM metrics group. The Agent tab scopes each metric to agent activity, and the LLM tab scopes it to the LLM. All metrics in this group read from the LLM metrics source and support no channel or tool filters.Tool metrics
Tool metrics read from the Platform events source. All three support channel filters, channel connection scope, and tool name and type filters.Voice metrics
Voice metrics read from the Platform events source. All support channel filters and channel connection scope, and none support tool name and type filters.Other metrics
The Others tab groups trace and sentiment metrics. Trace records
Conversation sentiment
Agent transfer
The Agent Transfer Settings page configures defaults for agent transfer sessions, routing, voice gateway, and PII handling. These settings apply project-wide unless an individual agent or workflow overrides them at runtime. Navigation: Project → Settings → Agent Transfer The page organizes content into three collapsible sections. Select a section header to expand or collapse it. Select Save to apply changes or Reset to restore all values to defaults.Default routing
Default Routing sets the fallback connection, queue, priority, and post-transfer behavior that the platform uses when an agent initiates a transfer. Individual agents or workflows can override these values at runtime.Voice Gateway
Voice Gateway configures transfer behavior for voice channels. These settings determine how the platform hands off calls to the agent desktop over SIP or PSTN. If SIP settings are also defined in the agent DSL, the runtime resolves the transfer destination using the following priority order: the agent-defined default, then the project setting. If neither is available, the transfer fails. Learn how to define Trusted SIP Transfer Destinations in ABL.
PII handling
PII Handling controls how the platform treats personally identifiable information when transferring a conversation to a human agent.Recording
An account admin must turn on call recording for the workspace (Account → Workspace Settings) before a project admin/developer can turn it on for individual projects. Recording applies only to calls that start after you enable this setting - calls already in progress or completed earlier aren’t captured retroactively.This differs from the Studio softphone Record call option. The softphone option captures a temporary audio file in the browser for a single test call, which can only be downloaded. It is lost when the popover is closed, does not appear on the session page, and is unaffected by these settings.
Click Save changes to apply your settings, or Reset to discard unsaved changes and restore the last saved values.
After a call ends, the runtime fetches and stores the finalized audio in the background, so a recording isn’t available immediately. Retention cleanup runs hourly and removes expired recordings automatically unless they’re marked immutable.
- You must have the
recording:writepermission to modify these settings. By default, this permission is assigned to theAdminandDevelopersystem roles. Users with theTesterorViewerrole can view the settings but cannot modify them. - Recording applies only to calls that start after you enable this setting - calls already in progress or completed earlier aren’t captured retroactively.
- Changes to the Retention days setting apply only to recordings created after you save the new setting. Existing recordings retain the retention period that was assigned when they were created. For example, reducing the retention period from 90 days to 30 days does not shorten the lifetime of existing recordings.
Public API access
The Public API Access page configures which APIs end-users can access when authenticating through their organization’s identity provider (Azure AD, Okta, Google). Navigation: Project → Settings → Public API AccessQuery API
Toggle the Query API to allow authenticated end-users to query agents through the public API endpoint. When you enable it, the following configuration fields appear:
Session token duration
Public Widget Data
The Public Widget Data page controls the tables, columns, and SQL constructs that saved widgets can expose through theanalytics:read scope. Projects start with sensitive analytics sources blocked, and all SQL constructs beyond a basic single SELECT stay disallowed until you enable them. Click Save policy to apply your changes.
Navigation: Project -> Settings -> Public Widget Data
SQL validation
Choose which saved-widget SQL constructs the platform allows foranalytics:read queries. DDL and mutation statements remain blocked regardless of these settings.
Restricted data
The Restricted data section lets you block specific analytics tables and columns from saved widgets. Every project contains a default configuration that restricts a few sensitive sources. You can remove a default restriction or add your own. After updating the restrictions, save the policy. Block a table- Choose a table from the Select a table menu.
- Click Block table.
abl_platform.audit_eventsabl_platform.eval_conversationsabl_platform.eval_scoresabl_platform.hallucination_evaluationsabl_platform.knowledge_gap_evaluationsabl_platform.llm_evaluateabl_platform.search_queriesabl_platform.spatial_trace_recordsabl_platform.custom_pipeline_resultsabl_platform.workflow_events
- Choose a scope from the table menu. Select All tables to block the column everywhere it appears, or select a specific table to block it there only.
- Choose a column from the Select a column menu.
- Click Block column.
attributescontentconversation_jsonevidencemetadataoutputpayloadpromptquery_texttrace_events
Attachments
The Attachment Settings page controls how files uploaded during chat sessions are accepted and processed for this project. Navigation: Project → Settings → Attachments General
Upload Limits
Default Allowed File Types
The following MIME types are allowed by default:
- Images:
image/jpeg,image/png,image/gif,image/webp - Documents:
application/pdf,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document,application/rtf - Spreadsheets:
application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet - Presentations:
application/vnd.ms-powerpoint,application/vnd.openxmlformats-officedocument.presentationml.presentation - OpenDocument formats:
application/vnd.oasis.opendocument.text,application/vnd.oasis.opendocument.spreadsheet,application/vnd.oasis.opendocument.presentation - Text formats:
text/plain,text/markdown,text/csv,text/tab-separated-values,text/html,application/xml,application/json - Audio:
audio/mpeg,audio/wav,audio/webm - Video:
video/mp4,video/webm
- Redact (Default): Detects and masks PII before the extracted content is indexed or made available to downstream services.
- Block: Stops processing the file if PII is detected.
- Allow: Processes the file without applying PII detection or redaction.
PII policies are applied only when the platform extracts file contents (Full processing mode). They are not applied in Metadata Only or Skip mode.
-
Full (Default): Processes files and extracts content from supported file types. The extracted content is then shared with the models as context. The models receive content as per the file types.
- Images: A resized version of the image is sent directly to the model as Base64. The model analyzes the image itself. No extraction is done by the platform.
- Documents, audio, and video: The platform extracts the content and sends only the extracted text to the model. The raw file is not sent. In case of audio and video files, the transcripts are shared. In this mode, File metadata remains available through the attachment tools. Use this mode when the agent needs to read, search, and reason about uploaded content.
- Metadata Only: Stores uploaded files without processing their contents. The model cannot access or understand the contents of the uploaded file. The model gets file metadata (name, size, download url).
- Skip: Bypasses the platform’s content extraction pipeline. This mode is only supported for image and pdf files. For supported types, the platform sends the original file directly to the selected LLM provider. Use this mode when you want to use the LLM provider’s native document or vision capabilities instead of the platform’s extraction pipeline.
Supported only when the selected LLM provider and model support native file or vision input.
- Images in Full mode are sent directly to the model. Therefore, the selected model must support vision.
- Documents, audio, and video in Full mode are converted into text before being sent to the model, allowing any text-capable model to process them.
- Metadata Only and Skip do not extract file contents. As a result, PII policies are not applied in these modes.
- In Skip mode, direct file transfer is currently supported only for images and PDF files.
Omnichannel
The Omnichannel page configures cross-channel session continuity. Navigation: Project → Settings → Omnichannel Omnichannel settings allow users who start a conversation on one channel to continue it on another without losing context. Conversation Recall
Allowed channels
Lists all supported channels (web, voice, sms, whatsapp, email, slack, teams) with toggles for cross-channel recall participation.
Identity Requirements
Consent
Live Transcript Sync
Configure real-time transcript synchronization settings for cross-channel sessions.
Recent Continuity Activity
Shows operational events generated by cross-channel recall and live session continuity — for example, a session transferring channels or a live sync joining. Select Refresh to reload the list. If no sessions have used continuity features yet, the panel shows an empty state.
Click Save Settings to apply changes.
If you see a “Failed to save settings” error, verify that your role has write permissions for project settings.
Governance
The Governance page sets the production approval policy for this project. The policy controls how strictly the platform gates production deployments, so a stricter level requires more sign-off before an agent version can ship. Navigation: Project → Settings → Governance Production approval policy The page shows whether the policy is Inherited (default) or set explicitly for the project, along with the Effective level currently in force and its source (for example, Standard from the platform default). To set an explicit policy, drag the Approval strictness slider to a level, then click Save policy.
When you select a level, the page shows that level’s sign-off requirements below the slider. Saving an explicit policy overrides the inherited platform default.