Published at: 2026-09-17
Account briefing agent user and configuration guide
This guide explains how to use and configure the Account Briefing Agent. It also describes the applicable rules.
Overview
The Account Briefing Agent uses CRM data and long-term account memory.
The system turns this information into decision-ready materials for account management.
It is not an account field list.
It organizes fragmented information into actionable business judgments.
Applicable roles and business value
Value for AEs
- Quickly understand meeting goals, key stakeholders, and risks before a visit.
- Build a complete account view automatically from multiple CRM objects.
- Use the Account 360 profile to understand the decision chain, pain points, and competitors.
- Spend less time repeatedly preparing materials before an executive visit.
- Preserve relationships, commitments, and history during an account handover.
Value for sales managers
- Quickly determine whether an account requires executive involvement.
- Review account preparation quality with a standard template.
- Reduce account churn risk with a handover briefing.
- Give executives a clear role, boundary, and follow-up plan for each visit.
Value for the organization
- Preserve long-term account memory.
- Turn personal experience into an organization asset.
- Standardize account insights, pre-meeting preparation, and handover process.
- Surface budget, competitor, delivery, and relationship risks early.
- Support the account details page, stored briefings, and manual refresh.
Scenario selection
| Current goal | Recommended briefing | Primary audience | Result focus |
|---|---|---|---|
| Build a complete account view | Standard Account 360 profile | AE, account manager | account profile, decision chain, opportunities, and risks |
| Prepare for a visit or meeting | Pre-visit account briefing | AE, account manager | Pre-meeting conclusion, goals, warnings, and actions |
| Request executive attendance | Executive visit briefing | Sales manager, attending executive | Value of involvement, boundaries, and post-meeting ownership |
| Hand over an account | Team account handover briefing | New owner, sales manager | Relationship history, commitments, risks, and first-week actions |
Skill list
| Briefing | Skill | Typical trigger |
|---|---|---|
| Pre-visit account briefing | sfa-account-pre-visit-briefing |
Before a visit, visit, meeting, or departure |
| Standard Account 360 profile | sfa-account-standard-briefing |
Account 360, account profile, or account overview |
| Executive visit briefing | sfa-account-executive-visit-briefing |
Executive attendance, executive involvement, or opportunity escalation |
| Team account handover briefing | sfa-account-handover-briefing |
account handover, account reassignment, or AE transfer or departure |
Basic workflow
- Identify the account.
- Retrieve CRM data for the selected business scenario.
- Retrieve sourced account memory.
- Separate facts, inferences, and unknown items.
- Present the conclusion first, followed by risks and actions.
[!NOTE] Insufficient permission does not mean no data. The briefing preserves the actual data coverage status.
Recent updates and maintenance
This guide covers four account briefing types.
Each type supports a scenario-specific data depth.
- When you update scenario capabilities, also update the steps and output structure.
- When you update CRM fields, also update data sources and coverage status.
- When you update Agent routing, revalidate the quick-start workflow.
- When you update a template, verify all three briefing modes.
Quick start
Generate a briefing as a business user
[!IMPORTANT] Confirm that you have Read Only access to the intended account and its associated records.
- In Agent conversation, enter an account name, Account No., or ID.
- Describe the current business scenario.
- Add meeting, opportunity, or handover context.
- Select the required briefing mode.
- View the conclusion summary and data coverage status.
- Follow the risks and recommended actions to move account tasks forward.
| Goal | Example request |
|---|---|
| Account research | Generate a standard Account 360 for account A. Focus on the decision chain and competitors. |
| Pre-meeting preparation | Generate a pre-visit briefing for account A. Focus on budget and key stakeholders. |
| Executive visit | Generate an Executive visit briefing for account A. Describe the executive’s involvement boundaries. |
| Account handover | Generate a handover briefing for account A. List commitments and first-week actions. |
Complete the minimum configuration as an admin
[!IMPORTANT] Confirm that you have Agent configuration permission.
- In Agent configuration, create an Account Briefing Agent.
- Mount all four skills in Skill mounting.
- Configure scenario trigger phrases in Intent routing.
- Assign read-only access for account-related objects to business roles.
- Validate fields for accounts, opportunities, contacts, and sales records.
- Use a test account to validate all four routing paths.
Expected results
- The request matches the correct briefing scenario.
- The briefing displays the conclusion and data coverage status first.
- Insufficient permission is not labeled as no data.
Account briefing scenarios
Standard Account 360 profile
The standard Account 360 profile supports account research and daily account management.
It does not require actions for a meeting scheduled today.
Capabilities
| Capability | Description |
|---|---|
| Account profile | Summarizes basic info, industry, scale, strategic updates, and key gaps |
| Engagement timeline | Organizes events, interactions, commitments, and relationship changes from the previous 12 months |
| Relationship score | Rates each key stakeholder from -5 to +5 |
| Decision chain and stakeholder map | Identifies roles, coverage, blockers, and influence paths |
| Complete opportunity view | Shows project origin, budget approval, current IT environment, and historical opportunities |
| Pain point map | Separates confirmed, inferred, and pending-validation pain points |
| Competitor overview | Shows competitor stage, quote, strengths, weaknesses, and historical outcomes |
| Open questions and risk matrix | Records unknown items, conflicting facts, risks, and mitigation directions |
full mode |
Adds cooperation history, financial information, renewal signals, and churn signals |
Typical triggers
- Help me understand this account.
- Generate an Account 360.
- Generate an account profile, complete account view, or account overview.
- Generate an HTML account briefing or a web page account briefing.
Generation steps
- In Agent conversation, enter an account ID, Account No., or name.
- Ask for a “standard Account 360” or an “account profile.”
- Specify
fullmode when you need the complete history. - Review the conclusion summary and information completeness.
- View the account profile, relationships, opportunities, competitors, and risks.
Processing SOP
| Step | Process |
|---|---|
| Identify the account | Identify by account ID, Account No., fuzzy name search, and name normalization in sequence |
| Retrieve baseline data | Retrieve accounts, opportunities, contacts, and sales records |
| Retrieve conditional data | Retrieve competitor details when competitor signals exist |
| Retrieve complete data | In full mode, add contracts, sales orders, payment collection, and account health data |
| Retrieve memory | Extract historical negotiations, relationship changes, commitments, and key events |
| Load rules | Generate the profile, timeline, decision chain, pain points, and risk matrix |
| Generate Markdown | Present the conclusion first, followed by each analysis module |
| Generate HTML | Use standard_briefing.html to create the presentation version |
Output structure
| Order | Module | Focus |
|---|---|---|
| 1 | Conclusion summary | Account status, key opportunities, and primary risks |
| 2 | Account profile | Basic info, industry, scale, and strategic updates |
| 3 | Engagement timeline | Interactions, commitments, competitors, and relationship changes |
| 4 | Relationship score | Relationship trends and evidence for key contacts |
| 5 | Decision chain and stakeholder map | role coverage, blockers, and influence paths |
| 6 | Project background and opportunity overview | Required conditions, budget, IT environment, and historical opportunities |
| 7 | Pain point map | confirmed, inferred, and pending-validation pain points |
| 8 | Competitor overview | Competitor stage, quote, strengths, weaknesses, and outcome records |
| 9 | Open questions and risk matrix | unknown items, conflicting facts, and mitigation directions |
| 10 | Cooperation and financial history | Added only in full mode |

Expected results
- The output separates facts, inferences, and unknown items.
- Each data category retains its actual retrieval status.
fullmode adds cooperation and financial history.
Information completeness
| Level | Criteria |
|---|---|
| Complete | Evidence covers basic info, 12 months of interactions, opportunities, contacts, pain points, and competitors |
| Partial | Basic info and some interactions exist, but the decision chain or financial history has gaps |
| Insufficient | Only the account name or a few fields exist, so the Agent cannot build reliable insight |
Pre-visit account briefing
The pre-visit briefing supports an upcoming visit or meeting.
It condenses account history into actions for that event.
Capabilities
| Capability | Description |
|---|---|
| Pre-meeting conclusion | Selects the main approach, such as closing, budget discovery, blocker removal, or context rebuilding |
| Primary goal | Keeps only the most important meeting goal |
| Risk warnings | Flags budget, commitments, competitors, key stakeholders, and negotiation limits |
| Visit readiness | Calculates information, pain point, competitive preparation, and comprehensive readiness scores |
| Stakeholder map | Identifies key roles, stance, and the communication approach for the day |
| Suggested on-site questions | Provides the opening statement, key questions, and action priority |
| Engagement timeline | Expands details for renewal, expansion, competitor, or historical commitment scenarios |
| Three output modes | Supports lite, normal, and full |
Typical triggers
- Generate a pre-visit briefing.
- I am about to visit an account. Help me prepare.
- How should I approach today’s meeting?
- What is the current visit readiness score?
- What is the largest information gap?
Generation steps
- In Agent conversation, enter an account name or ID.
- Describe the meeting purpose and attendees.
- Add the current opportunity stage.
- Select
lite,normal, orfullmode. - Review the pre-meeting conclusion, risks, and primary goal.
- Bring the P0 actions and key questions into the meeting.
Processing SOP
| Step | Process |
|---|---|
| Retrieve context | Retrieve the account, attendees, meeting purpose, and opportunity stage |
| Retrieve baseline data | Retrieve accounts, opportunities, contacts, and the latest 3-5 interactions |
| Retrieve conditional data | Retrieve competitor details based on competitor signals or user requests |
| Retrieve memory | Extract only relationships, commitments, budget, and competitors that affect this meeting |
| Load rules | Load decision chain, pain point, competitor, and readiness rules for the selected mode |
| Calculate readiness | Prefer scripts/calc_ready_score.py |
| Generate the briefing | Present the pre-meeting conclusion first, followed by warnings and actions |
| Output HTML | Use visit.html and briefing.css |
Output structure
| Order | Module | Focus |
|---|---|---|
| 1 | Pre-meeting conclusion | One-sentence judgment about the primary meeting approach |
| 2 | 10-second identity tag | Account type, sentiment score, and organizational motivation |
| 3 | 30-second decision anchor | Primary goal, limits, and key choices |
| 4 | 20-second warning | 1-3 risks and corresponding on-site responses |
| 5 | Visit readiness | Comprehensive score and largest information gap |
| 6 | Stakeholder map | Person, role, stance, and communication approach |
| 7 | Engagement timeline | Effect of key events on this meeting |
| 8 | Actions for today | P0, P1, and P2 actions, plus actions to avoid |
| 9 | References and data coverage | Actual retrieval status for each object |

Expected results
- The first screen displays the pre-meeting conclusion and primary goal.
- Each risk has a corresponding on-site response.
- Each action includes an object, goal, and validation criteria.
[!NOTE] A pre-visit briefing does not replace a complete business diagnosis. Switch to the relevant specialized skill for in-depth analysis.
Executive visit briefing
The executive visit briefing supports high-value or high-risk account meetings.
It explains the value and boundaries of executive involvement.
Capabilities
| Capability | Description |
|---|---|
| Visit recommendation | States whether to recommend the visit, its value, the largest risk, and the executive’s role |
| Opportunity value | Summarizes amount, stage, strategic value, and the competitive window |
| Executives and key stakeholders | Organizes customer executives, key roles, relationship scores, and contact precautions |
| Risk sensitivities | Flags competitor, budget, delivery, payment collection, and historical commitment risks |
| Executive involvement | Defines the executive identity, questions, expected effect, and boundaries |
| Visit goals | Provides 1-3 goals and validation criteria |
| Post-meeting ownership | Defines actions for the AE, manager, presales, implementation, and executive |
| Output detail | Supports a concise version, detailed version, and full mode |
Typical triggers
- Write an executive visit briefing.
- I want a VP, director, or business leader to attend an account meeting.
- This opportunity requires executive escalation.
- Help me prepare an executive briefing.
Generation steps
- In Agent conversation, enter an account name or ID.
- Identify the requestor and the proposed executive attendee.
- Add the customer executive, time, format, and current blocker.
- Select the concise version, detailed version, or
fullmode. - Review executive involvement points and items that must not be promised.
- Assign an owner to each post-meeting goal.
Processing SOP
| Step | Process |
|---|---|
| Select detail | Use the concise version for executives and the detailed version for AE and manager preparation |
| Define the visit request | Identify the requestor, executive, customer executive, time, and format |
| Retrieve memory | Extract executive relationships, historical escalations, commitments, and sensitive issues |
| Retrieve baseline data | Retrieve accounts, opportunities, contacts, and recent interactions |
| Retrieve risk data | For full mode or high risk, retrieve competitors, contracts, sales orders, and payment collection |
| Generate a judgment | State whether to recommend the visit, the executive’s value, and the largest risk |
| Define ownership | Assign an owner to each post-meeting goal |
| Generate HTML | Use executive_visit.html to create a two-column page |
Output structure
| Module | Core question |
|---|---|
| Visit recommendation | Should the executive attend, and what value does the executive provide? |
| Opportunity value | What are the amount, stage, and competitive window? |
| Executives and key stakeholders | Who should the executive meet, and what is the relationship status? |
| Risk sensitivities | Which items must not be promised during the meeting? |
| Executive involvement | Which problem should the executive address, and in which capacity? |
| Visit goals | Which verifiable goals must this visit achieve? |
| Post-meeting ownership | Who owns each follow-up action? |
Concise and detailed versions
| Detail | Output content | Reading scenario |
|---|---|---|
| Concise | Executive summary, key value, key people, risks, and visit goals | About 3 minutes for an executive |
| Detailed | Adds visit background, involvement points, ownership recommendations, and information gaps | Pre-meeting preparation for AEs and managers |
full |
Adds cooperation history, financial information, and account health | High-risk or complex accounts |

[!WARNING] An attending executive does not replace the AE’s basic follow-up. The executive must not promise an unconfirmed price or delivery scope.
Suitable scenarios
- A high-value strategic opportunity.
- Customer executives attend the meeting.
- Budget or approval blocks progress.
- A competitor is deeply involved.
- A renewal, expansion, or risk-recovery window exists.
Unsuitable scenarios
- A routine first visit before account needs are clear.
- The AE cannot explain what the executive should resolve.
- Key stakeholders, budget, competitors, and project value are all unclear.
- The only goal is to use an executive’s name to urge a customer response.
- The customer needs only product, quote, or implementation details.
Team account handover briefing
The team account handover briefing supports account reassignment and personnel changes.
It preserves relationships, commitments, risks, and first-week actions.
Capabilities
| Capability | Description |
|---|---|
| Required summary for the new owner | Describes the current status, historical burden, and handover priority |
| Handover background | Describes the reason, cooperation status, and urgency level |
| Account profile | Shows basic info, business status, and cooperation history |
| Engagement chronology | Reconstructs key events, relationship turning points, and commitment changes |
| Relationships and key stakeholders | Marks roles, stance, supporters, and blockers |
| Outstanding commitments | Records commitments from both parties, deadline date, and handling recommendations |
| Risk sensitivities | Flags internal relationships, disputes, delivery, and payment collection risks |
| Competitor history | Records competitor stage, outcome reasons, and competitive background |
full mode |
Adds contracts, sales orders, payment collection, health data, and churn reasons |
Typical triggers
- Hand over this account to a colleague.
- Generate an account handover briefing.
- What should I know before I take over this account?
- Organize account history when an AE leaves or changes roles.
Generation steps
- In Agent conversation, enter an account ID, Account No., or name.
- Describe the handover reason, new owner, and handover time.
- Select
normalorfullmode. - Review the new owner summary and handover background.
- Review key stakeholders, commitments, risks, and competitor history.
- Schedule first-week actions based on the handover recommendations.
Processing SOP
| Step | Process |
|---|---|
| Identify the account | Identify the primary account record with the multistage rules |
| Retrieve baseline data | Retrieve accounts, opportunities, contacts, and recent interactions |
| Retrieve conditional data | Retrieve competitor details based on competitor signals |
| Retrieve complete data | In full mode, add contracts, sales orders, payment collection, and health data |
| Retrieve memory | Extract historical negotiations, relationship changes, and commitment status |
| Load rules | Generate background, timeline, relationship, commitment, and risk modules |
| Generate the briefing | Present facts and handover recommendations separately |
| Generate HTML | Use handover.html and handover.css |
Output structure
| Order | Module | Focus |
|---|---|---|
| 1 | New owner summary | current status, historical burden, and priority |
| 2 | handover background | handover reason, cooperation status, and urgency level |
| 3 | Account profile | Basic info, business status, and cooperation history |
| 4 | Engagement chronology | Key events, relationship turning points, and commitment changes |
| 5 | Relationships and key stakeholders | Supporters, blockers, and contact precautions |
| 6 | Outstanding commitments | owner, deadline, and handling recommendations |
| 7 | Risks and competitors | sensitive issues, competitors, and historical outcome reasons |
| 8 | Handover recommendations | First-week actions and validation criteria |

Expected results
- Facts and recommendations are presented separately.
- Each commitment includes a status and handover action.
fullmode adds cooperation and financial history.
Admin configuration and data preparation
General account identification SOP
- First, query the CRM account
_idwith an exact match. - If the user provides an Account No., query it with an exact match.
- Without an ID or Account No., query
AccountObj.name LIKE <keyword>. - If an abbreviation returns no match, use
query-by-namefor name normalization. - If the query returns multiple candidates, ask the user to select the intended account.
- If the name returns no match but the ID matches, use the ID result.
- If nothing matches, state only that the current criteria returned no account.
<keyword> is the account name keyword that the user provides.[!IMPORTANT] Do not exclude account candidates yourself. Do not claim that the account does not exist in CRM.
General data query SOP
- Confirm the primary account record and
<account-id>. - Retrieve opportunities, contacts, and communication records.
- Run baseline queries in
normalmode. - Retrieve competitor details when competitor signals exist.
- In
fullmode, retrieve contracts, sales orders, and payment collection. - Record the data coverage status for each object.
- When permission is insufficient, do not mark the result as no data.
- Do not duplicate a query for an object with an unrecoverable error.
<account-id> is the primary account record ID.Agent mounting and intent routing
- Open the Account Briefing Agent in Agent configuration.
- Mount all four skills in Skill mounting.
- Configure trigger phrases in Intent routing.
- Use all four request types to validate routing results.
Mounting list
| Skill | Mount directory | Description |
|---|---|---|
| Pre-visit account briefing | sfa-account-pre-visit-briefing |
Pre-visit action briefing |
| Standard Account 360 | sfa-account-standard-briefing |
Standard account profile |
| Executive visit briefing | sfa-account-executive-visit-briefing |
Executive visit and opportunity escalation |
| Team handover briefing | sfa-account-handover-briefing |
account handover profile |
| User phrase | Routing target |
|---|---|
| Before a visit, visit, meeting, or departure | Pre-visit account briefing |
| Account 360, account profile, or account overview | Standard Account 360 profile |
| Executive attendance, executive involvement, or opportunity escalation | Executive visit briefing |
| Account handover, takeover, role transfer, or departure | Team account handover briefing |
CRM data sources and field validation
| Object | API name | Primary purpose |
|---|---|---|
| Account | AccountObj |
Name, industry, scale, deal status, source, and last follow-up time |
| Opportunity | NewOpportunityObj |
Current and historical opportunities, stage, amount, win rate, budget, and approval |
| Contact | ContactObj |
Key stakeholders, job role, primary contact, and role candidates |
| Sales records | ActiveRecordObj |
Interactions, account quotes, sentiment, commitments, pain points, and relationship changes |
| Competitor details | CompetitiveLinesObj |
Competitor name, strengths, weaknesses, quote, and outcome status |
| Contract | ContractObj |
Historical contracts, amount, period, and status |
| Sales order | SalesOrderObj |
Order amount, status, payment received, and accounts receivable |
| Payment collection | PaymentObj |
Payment collection amount, time, and receivables risk |
| Schedule | ScheduleObj |
Meeting plans, visit arrangements, and Not Completed items |
| Fieldwork | CheckinsObj |
On-site visit trail and communication record |
| Personnel | PersonnelObj |
Internal owner, AE, and sales manager |
- Confirm that each object exists in the object description API.
- Confirm each API name and field definition.
- Confirm that the account ID can associate core objects.
- Confirm that time-related fields, such as Confirmation Time, support scenario filters.
- Confirm that the user has object and field permissions.
- Use a test account to validate the returned data.
[!NOTE] Account health, CSM warnings, and churn reasons may come from custom data. Retrieve these fields only after schema validation is completed.
Memory and briefing modes
- Enable account memory in Account Briefing Agent configuration.
- Define readable key events, relationship changes, and commitment status.
- Configure allowed briefing modes for each scenario.
- Keep the memory access area consistent with user permissions.
- Use a test account to verify the source of historical events.
| Mode | Purpose | Applicable scenario |
|---|---|---|
lite |
Shortest action version | Urgent departures and quick decisions |
normal |
Default scenario version | Daily account management and meetings |
full |
Complete analysis version | High risk, reviews, and financial analysis |
Output and HTML templates
| Scenario | HTML template |
|---|---|
| Standard Account 360 | standard_briefing.html |
| Pre-visit account briefing | visit.html |
| Executive visit briefing | executive_visit.html |
| Team handover briefing | handover.html |
- Enable Markdown content in Output configuration.
- Select the corresponding template for each scenario.
- Keep the data coverage summary.
- Check readability on the desktop and mobile client.
- Confirm that Markdown and HTML use consistent facts.
General reference documents
Role tags
| Tag | Meaning | Use in the briefing |
|---|---|---|
EB |
Economic Decision Maker | Determine budget and final decision authority |
TB |
Technical Decision Maker | Determine technical constraints and feasibility |
UX |
User experience or business user | Determine actual needs and account feedback |
Coach |
A person willing to provide internal information | Find internal intelligence and an advancement path |
Gatekeeper |
A person who controls access or the process entry | Determine how to enter the decision chain |
Influencer |
A person who can influence a decision | Determine the area of relationship leverage |
Relationship score
| Score | Description |
|---|---|
+5 |
Actively drives internal decisions |
+3 |
Shows trust and provides information |
+1 |
Slightly positive and cooperates normally |
0 |
neutral |
-1 |
Distant and requires additional relationship management |
-3 |
Has clear reservations |
-5 |
Actively blocks progress |
Determine the relationship score from interactions, customer quotes, and key events.
Visit readiness
| Component | Rule |
|---|---|
| Information completeness | account, decision chain, interactions, pain points, and financial signals |
| Pain point fit | Pain point evidence and product fit |
| Competitive risk | Competitor stage, relationship comparison, and competitive preparation |
| CRM win rate adjustment | Apply a small adjustment based on opportunity probability |
| Comprehensive readiness | Completeness 35% + fit 35% + inverse competitive risk 30% + win rate adjustment |
| Score | Level | Recommendation |
|---|---|---|
80-100 |
Ready | Proceed with the meeting as planned |
60-79 |
Preparing | Complete the main information gaps |
40-59 |
Insufficient | Narrow the meeting goal |
0-39 |
At risk | recommend postponing or gathering evidence first |
Data coverage status
| Status | Meaning | Output requirement |
|---|---|---|
| Retrieved | The query succeeded and the system used the data | The data can support facts |
| No data | No matching record exists within the query scope | Clearly label the result as no data |
| Insufficient permission | The current user cannot access the data | Do not label the result as no data |
| Query not triggered | The current scenario does not require the object | Describe why the object was not retrieved |
| Query failed | An unrecoverable error occurred during retrieval | Retain the failed status and affected area |
Permissions, limitations, and boundaries
- Retrieve only data that the current user can access.
- Industry benchmarks and competitor references cannot replace account evidence.
- Label inferred content as an inference or pending validation.
- By default, the briefing does not write to CRM automatically.
- Writing to CRM requires separate authorization and user confirmation.
- After an unrecoverable error occurs for an object, do not repeat the query in the same run.
FAQ
This section does not include predefined troubleshooting entries.
Add symptoms, causes, and solutions later based on actual support cases.