Source: https://vaultcrmhelp.veeva.com/doc/Content/CRM_topics/VeevaAI/InsightCaptureAgent/Configuration.htm

## Configuring Agentic Insight Capture

### Configuring Agentic Insight Capture for

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#)

To configure this agent:

1. Ensure the following configuration is complete:

   * [Configuring Vault AI in CRM](../Configuration.htm)
   * [My Notes](../VoiceAgent/VoiceAgentMyNotes.htm)
   * [Voice Dictionary Entries](../VoiceDictionary.htm)
2. Grant users **Execute** permission to the Insight Capture Agent:

* Navigate to **Admin > Users & Groups > Permission Sets**
* Select the appropriate permission set
* Select the **Agents** tab
* Select the **Execute** checkbox for the Insight Capture Agent

3. Activate the Insight Capture Agent:

* Navigate to **Admin > Configuration > Vault AI Setup > Agents**
* Select the **Insight Capture Agent**
* Select **Edit**
* Select **Active** in the Status picklist
* Select **Save**
* Expand the **Actions** section
* Verify the following agent action is Active:
* **Capture Commercial Insight** (capture\_commercial\_insight\_\_v) - Takes the transcription and transposes it into a Commercial Insight record

#### Optional Configuration

When [Agentic Insight Quality](../InsightQualityAgent/InsightQualityAgentOverview.htm) is enabled, a quality check automatically runs for new insights captured with Agentic Insight Capture. Admins can control this behavior using the Insight Quality Check AI Setting.

To determine whether these checks run automatically for insights captured with Agentic Insight Capture:

1. Navigate to **Business Admin > Objects > ai\_settings\_\_v**.
2. Populate the **insight\_quality\_check\_\_v** setting:

* To run quality checks automatically, leave the setting blank or set it to **Automatic from Agentic Entry**
* To require users to manually initiate the quality check, set the value to **On-Demand**

### Configuring Insight Definition Rules as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Admin Users](#)

When [Agentic Call Report™](../AgenticCallReport/AgenticCallReport.htm) is enabled and users record a Call Voice Note, Agentic Insight Capture uses Insight Definition Rules to automatically detect commercially relevant information. The agent extracts any commercially relevant information from the Call Voice Note, as determined by Insight Definition Rules, and captures it as a Commercial Insight on the call report.

To configure Insight Definition Rules:

1. Select the **Objects** tab.
2. Grant the following permissions:

   | Object | Object Permission | Object Types | Fields | Field Permission |
   | --- | --- | --- | --- | --- |
   | agent\_rule\_\_v | R | insight\_definition\_rule\_\_v | * insight\_type\_\_v * instruction\_\_v | Read |
3. Navigate to **Business Admin > Objects > vmobile\_object\_configurations\_\_v**.
4. Activate **agent\_rules\_\_v** VMOCs for the appropriate platforms.
5. Navigate to **Business Admin > Objects > agent\_rules\_\_v**.
6. Set the status of each rule with a type of **Insight Definition Rule** to Active. On Veeva-provided rules, admins can only update the Status and Display Order fields.

#### Standard Rules

Veeva provides the following standard rules by default:

* **Barrier** - The stakeholder describes a factor that is limiting or preventing them, their patients, or other stakeholders from adopting or using the product. Does not include factors that have already been resolved or addressed.
* **Need** - The stakeholder requests information, resources, services, capabilities, or changes that could improve decision-making, adoption, implementation, or patient care. Does not include requests that have already been addressed or that the representative has already stated a plan to address.
* **Unmet Clinical Need** - The stakeholder identifies a gap in current treatment options where existing therapies do not adequately address patient needs. Can include limitations in efficacy, safety, durability, tolerability, convenience, or available treatment options for a patient population.
* **Influencer Signal** - Indicates that the stakeholder meaningfully influences the clinical decisions, product adoption, purchasing decisions, or practice behaviors of other healthcare professionals or institutions. Can include serving as a key opinion leader, clinical leader, department champion, referral leader, speaker, educator, committee member, or other influential decision-maker. Does not include mention of collaborating or working with other providers without a described effect on their clinical decisions or practice behavior.
* **Peer Influence Signal** - Indicates that the stakeholder's product adoption or clinical decision making are influenced by the opinions, experiences, or behaviors of peers, key opinion leaders, professional networks, or other healthcare organizations. Can include relying on respected colleagues, waiting for broader peer adoption, following academic centers, or seeking recommendations from key opinion leaders. Does not include mention of collaborating or working with other providers without a described effect on their clinical decisions or practice behavior.
* **Competitive Activity** - The stakeholder describes actions, strategies, or commercial initiatives undertaken by a specific competing product, manufacturer, or organization that may influence treatment decisions or the competitive landscape. Can include competitor promotion, pricing or contracting strategies, educational initiatives, speaker programs, sales force activities, patient support programs, or other commercial actions. Does not include mere mention of a competitor, competitor product, or competitor representative with no described relationship or meaningful activity.
* **Marketing Resonance** - The stakeholder provides feedback indicating whether marketing messages, promotional materials, or commercial content effectively communicated the intended messages. Can include reactions to messaging, sales aids, presentations, patient profiles, educational materials, or promotional resources. Does not include neutral or no reaction to marketing activity.
* **Marketing Gap** - The stakeholder identifies deficiencies, omissions, or opportunities to improve commercial messaging, promotional materials, or supporting resources. Can include missing comparisons, insufficient educational materials, unclear positioning, lack of patient or educational resources, or requests for additional promotional content. Does not include neutral or no reaction to marketing activity.
* **Market Dynamics** - The stakeholder describes broader trends or changes affecting the market, competitive landscape, or healthcare environment that may influence product adoption decisions or future market opportunities. Can include changes in treatment patterns, standards of care, payer trends, diagnostic trends, emerging therapies, new competitors entering the market, anticipated regulatory or guideline changes, or other shifts in the healthcare landscape.

Business admins can activate or deactivate any of these default rules. However, the Veeva-provided default rules cannot be edited or deleted.

Business admins only need to create the rules in English. By default, all rules are translated into the user's language.

#### Custom Rules

To create a custom Insight Definition Rule:

1. Navigate to **Business Admin > Objects > Agent Rules**.
2. Select **Create**.
3. Select **Insight Definition Rules** as the insight type.
4. Enter a **Rule Name**.
5. Enter detailed instructions for the agent in the **Instruction** field. This defines how the agent should evaluate the text.
6. Set the Status to **Active**.
7. Save the record.

Customers are responsible for testing and validating the responses for any custom rules that are configured.

### Configuring Language and Locale Settings as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Admin Users](#)

All Vault CRM [Supported Languages](../../Reference/Supported_Languages.htm) are also supported for the user interface, generated content, and CRM interactions. However, speech recognition quality depends on the language and region combinations that Apple iOS officially supports.

To ensure successful call transcription and accurate voice dictionary mapping, make sure the following all match:

* Language the user speaks
* Language set on the Vault User record (language\_\_sys field on the user\_\_sys record)
* iOS device language and region, found under Settings on the user's iOS device
* Active keyboard and dictation language, found under Settings on the user's iOS device

Mixed-language configurations or content are not supported and can cause transcription or mapping failures. Veeva does not guarantee performance or accuracy for language and region combinations not supported by Apple iOS, or provide technical support for unsupported speech-to-text locales.

If the device language and region combination is not supported by iOS speech recognition, users receive an alert notifying them that transcription is not supported in their device's language when they attempt to capture voice dictation. To resolve the issue, update the device language and region to match.

### Creating Voice Dictionary Entries as

[![Closed](../../../../Skins/Default/Stylesheets/Images/transparent.gif)Admin Users](#)

To ensure Agentic Insight Capture correctly recognizes and transcribes specific pronunciations—for example, unique product names, abbreviations, and regional or company-specific phrases—admin users create Voice Dictionary Entries. These entries can be applied across the Vault CRM instance or applied only to specific user languages and countries. For more information, see [Voice Dictionary Entries](../VoiceDictionary.htm).

### Related Topics

[Agentic Insight Capture Overview](InsightCaptureAgentOverview.htm)

[Agentic Insight Quality for Medical Insights](../InsightQualityAgent/InsightQualityAgentMedicalInsights.htm)

[Custom Rules for Agentic Insight Quality](../InsightQualityAgent/CustomRules.htm)

[Flightpath: Agentic Insight Quality](https://vaultcrmflightpath.veeva.com/doc/Content/VeevaAI/InsightQualityAgent/1.Intro.htm)