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

  1. Identify the account.
  2. Retrieve CRM data for the selected business scenario.
  3. Retrieve sourced account memory.
  4. Separate facts, inferences, and unknown items.
  5. 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.
  1. When you update scenario capabilities, also update the steps and output structure.
  2. When you update CRM fields, also update data sources and coverage status.
  3. When you update Agent routing, revalidate the quick-start workflow.
  4. 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.
  1. In Agent conversation, enter an account name, Account No., or ID.
  2. Describe the current business scenario.
  3. Add meeting, opportunity, or handover context.
  4. Select the required briefing mode.
  5. View the conclusion summary and data coverage status.
  6. 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.
  1. In Agent configuration, create an Account Briefing Agent.
  2. Mount all four skills in Skill mounting.
  3. Configure scenario trigger phrases in Intent routing.
  4. Assign read-only access for account-related objects to business roles.
  5. Validate fields for accounts, opportunities, contacts, and sales records.
  6. 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

  1. In Agent conversation, enter an account ID, Account No., or name.
  2. Ask for a “standard Account 360” or an “account profile.”
  3. Specify full mode when you need the complete history.
  4. Review the conclusion summary and information completeness.
  5. 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
Standard Account 360 output example

Expected results

  • The output separates facts, inferences, and unknown items.
  • Each data category retains its actual retrieval status.
  • full mode 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

  1. In Agent conversation, enter an account name or ID.
  2. Describe the meeting purpose and attendees.
  3. Add the current opportunity stage.
  4. Select lite, normal, or full mode.
  5. Review the pre-meeting conclusion, risks, and primary goal.
  6. 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
Pre-visit account briefing output example

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

  1. In Agent conversation, enter an account name or ID.
  2. Identify the requestor and the proposed executive attendee.
  3. Add the customer executive, time, format, and current blocker.
  4. Select the concise version, detailed version, or full mode.
  5. Review executive involvement points and items that must not be promised.
  6. 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
Executive visit briefing output example
[!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

  1. In Agent conversation, enter an account ID, Account No., or name.
  2. Describe the handover reason, new owner, and handover time.
  3. Select normal or full mode.
  4. Review the new owner summary and handover background.
  5. Review key stakeholders, commitments, risks, and competitor history.
  6. 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
Team account handover briefing output example

Expected results

  • Facts and recommendations are presented separately.
  • Each commitment includes a status and handover action.
  • full mode adds cooperation and financial history.

Admin configuration and data preparation

General account identification SOP

  1. First, query the CRM account _id with an exact match.
  2. If the user provides an Account No., query it with an exact match.
  3. Without an ID or Account No., query AccountObj.name LIKE <keyword>.
  4. If an abbreviation returns no match, use query-by-name for name normalization.
  5. If the query returns multiple candidates, ask the user to select the intended account.
  6. If the name returns no match but the ID matches, use the ID result.
  7. 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

  1. Confirm the primary account record and <account-id>.
  2. Retrieve opportunities, contacts, and communication records.
  3. Run baseline queries in normal mode.
  4. Retrieve competitor details when competitor signals exist.
  5. In full mode, retrieve contracts, sales orders, and payment collection.
  6. Record the data coverage status for each object.
  7. When permission is insufficient, do not mark the result as no data.
  8. 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

  1. Open the Account Briefing Agent in Agent configuration.
  2. Mount all four skills in Skill mounting.
  3. Configure trigger phrases in Intent routing.
  4. 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
  1. Confirm that each object exists in the object description API.
  2. Confirm each API name and field definition.
  3. Confirm that the account ID can associate core objects.
  4. Confirm that time-related fields, such as Confirmation Time, support scenario filters.
  5. Confirm that the user has object and field permissions.
  6. 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

  1. Enable account memory in Account Briefing Agent configuration.
  2. Define readable key events, relationship changes, and commitment status.
  3. Configure allowed briefing modes for each scenario.
  4. Keep the memory access area consistent with user permissions.
  5. 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
  1. Enable Markdown content in Output configuration.
  2. Select the corresponding template for each scenario.
  3. Keep the data coverage summary.
  4. Check readability on the desktop and mobile client.
  5. 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.
Submit Feedback