--- sourceDocument: Yokohama ServiceNow AI Platform Capabilities sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/servicenow-platform Release : - yokohama ft:locale : - en-US ft:publication_title : - Yokohama ServiceNow AI Platform Capabilities ft:clusterId : - platcap bundleId : - platcap workflow : - Platform --- # Using Agent Affinity # Using Agent Affinity {#ariaid-title1} * Release version: Yokohama * * Updated January 30, 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Using Agent Affinity Agent Affinity is an Advanced Work Assignment (AWA) feature in ServiceNow Yokohama release that enhances the work assignment process by factoring in an agent's work history, related tasks, or account team roles. While AWA typically assigns work based on agent availability, capacity, and skills, Agent Affinity customizes this process to ensure that work items are routed to the most suitable agent---often the same agent who previously handled similar or related work. This improves continuity and customer experience by avoiding repeated orientation with new agents. Show full answer Show less **Important:** Agent Affinity rules augment but do not override existing assignment eligibility or constraints defined in AWA rules. ## Key Features * **Types of Agent Affinity:** * **Historical:** Assigns work to agents based on past service history with the same customer. * **Related Task:** Assigns work based on previous assignments of related tasks. * **Account Team:** Assigns work based on an agent's role or responsibility within the customer's account team (available only for Customer Service Management customers). * **Affinity Rules and Queues:** Up to three affinity rules can be associated with each AWA queue, and the order of these rules determines the priority in agent selection. * **Example Workflow:** When a customer initiates a new interaction, AWA first tries to assign the work to an agent based on related task affinity. If that agent is unavailable, it tries account team affinity, and finally historical affinity, assigning to the best available agent with capacity at each step. ## Practical Use for ServiceNow Customers * Configure Agent Affinity rules to tailor how work items are routed within AWA queues, improving assignment accuracy and customer satisfaction. * Set the priority order of affinity rules to reflect your business needs and agent roles. * Deactivate Agent Affinity if you prefer to assign work solely based on standard AWA criteria without affinity considerations. * Leverage Agent Affinity especially in Customer Service Management scenarios to maintain consistent agent-customer relationships and faster issue resolution. ## Next Steps * Create or modify Agent Affinity rules in your instance to align with your support model. * Associate affinity rules correctly with AWA queues and define their priority order. * Monitor agent availability and capacity to ensure effective utilization of affinity-based assignments. Agent Affinity is an Advanced Work Assignment feature that lets you assign work items by an agent's work history, related task, or account team affinity. Advanced Work Assignment assigns work items to agents by their availability, capacity, and skills. You can use Agent Affinity to customize this AWA assignment process and identify the agent best suited for the work item. Agent Affinity ensures that the same agent is assigned to a similar work item instead of orienting a new agent every time. Note: Agent Affinity rules do not override assignment eligibility or constraints that are specified on AWA assignment rules. The types of affinities are: Historical : Identifies the best agent based on the agent's history of serving the same customer. Related task : Identifies the best agent based on the agent's past assignments of related tasks. Account team : Identifies the best agent based on the agent's responsibility or role in the account team. Note: Account team affinity is available only to Customer Service Management customers. Affinity rules are associated with AWA queues. Up to three rules can be associated with each queue. The affinity order determines how the assignment engine ranks the agents. The agent with the higher order affinity rule is considered as the best agent first. The following example shows how AWA uses Agent Affinity to determine the best agent for a work item. In this example, AWA is configured to use all three affinities in this order: related task affinity, account team affinity, and historical affinity. George Warren, who is a customer at the Boxeo company, has a router problem. George previously contacted support to report an issue. That case was assigned to agent Ned. The primary support agent for Boxeo is agent John. Within the past seven days, another agent, agent Beth, addressed a chat with Boxeo. The next time George initiates a customer service chat from the case page, the case is automatically added as a related task to the chat interaction. Agent Affinity uses the related task affinity to look for an agent who has fulfilled past assignments for a related task. Because agent Ned was assigned to a related task on the record, AWA assigns the work item to agent Ned if available with capacity. Figure 1. Example of related task affinity If agent Ned is unavailable or doesn't have the capacity, AWA uses the account team affinity. AWA looks for another agent based on an agent's responsibility or role in the account team. Because agent John is the primary support agent for the Boxeo company, AWA assigns the work item to Agent John if available with capacity. Figure 2. Example of account team affinity If agent John is not available, AWA uses the historical affinity and looks for an agent that has recently interacted with the company. This information is stored on the Agent Affinity screen. Because agent Beth addressed a chat with Boxeo within the past seven days, AWA assigns the work item to agent Beth if available with capacity. Figure 3. Example of historical affinity * **[Configure Agent Affinity rules](https://www.servicenow.com/docs/CNccvExZUq3L32EUIangoA)** Create or change the Agent Affinity rules that route work items in Advanced Work Assignment. * **[Set Agent Affinity rules](https://www.servicenow.com/docs/Obta15~azPIP27MKtPJDFw)** Specify the Agent Affinity rules to determine the order in which work items in a queue are sorted. * **[Deactivate Agent Affinity](https://www.servicenow.com/docs/oKVPJJ6pYPn6vlQmU7JJ0g)** Deactivate Agent Affinity if you do not want Agent Affinity to assign work assignments to agents. **Related concepts** * [Advanced Work Assignment home page](https://www.servicenow.com/docs/Wd1PNoMiYt8Wt5qtHoWtyg "Explore, implement, and maintain ServiceNow Advanced Work Assignment using a home-page experience. Discover AWA, install relevant plugins, and configure settings for AWA through the Advanced Work Assignment home page available to admins.") * [Service channels](https://www.servicenow.com/docs/5t9FJiWsjRwHNOlVA4Z~2w "Provide customer support by automatically routing incoming work to agents through service channels.") * [Work items](https://www.servicenow.com/docs/u~jHTlQpHL9ULAWUp5PARg "View Advanced Work Assignment work items using the Work Items menu options.") * [Work assignments](https://www.servicenow.com/docs/3Jj90y_b753QUpWy1CVd2w "After routing work items to the appropriate queues and corresponding agent groups, Advanced Work Assignment (AWA) pushes work to the most qualified agent using the assignment criteria that you specify. Assignment criteria revolve around the type of assignment rule (most capacity or last assigned) and whether skills are defined.") * [Agent Inbox controls](https://www.servicenow.com/docs/x7i1eMTygMVoUm21ZfNvHw "Control certain elements of the agent experience in Agent Workspace. Define the agent presence (availability) states and the work item rejection reasons used by agents to decline work assignments in their Agent Workspace inbox.") * [Advanced Work Assignment Inbox Sentiment display](https://www.servicenow.com/docs/dYNZowrhGk8ooEsBxMuC2A "Surface the sentiment in AWA Inbox for agents to get the visibility of requester sentiment ( if available) during live agent handoff or agent transfer for all channels.") * [Wrap up overview](https://www.servicenow.com/docs/yUy6RybTWyfJut8~FyiJfQ "When agents close an interaction, the wrap up feature enables them to enter closing details and wrap up codes for future reference.") * [Management](https://www.servicenow.com/docs/IivMVQZwO4rV7orc6brNCA "Configure Advanced Work Assignment properties using the Management menu options.") * [AWA group queue priorities](https://www.servicenow.com/docs/Wm1xADTIBCbUHGcs2tR99A "Use the group queue priority feature to set a queue or work item preference for a given group of agents. For a given group or agent with limited capacity, this feature controls which queues should be preferred if matching work items are found in both.") **Related tasks** * [Get started with Advanced Work Assignment](https://www.servicenow.com/docs/05NHc_mXecZZkvDMuHFmCw "To implement Advanced Work Assignment, complete these initial configuration and setup steps.") * [Install Conversational SMS service channel](https://www.servicenow.com/docs/7bjsf2CNPqMGS~UkZF0JZg "You can install the Conversational SMS service channel application (sn_awa_sms_int) if you have the admin role. The application installs related ServiceNow Store applications and plugins if they are not already installed.") * [Activate Agent Affinity](https://www.servicenow.com/docs/DIuzTNN5XR6bK4izO1G~Zw "You can activate the Agent Affinity plugin (com.glide.awa.agent_affinity) if you have the admin role.") * [Activate Conversational Messaging](https://www.servicenow.com/docs/ZsGtlxiwEGaC3yGxvM1gaw "You can activate the Conversational Messaging plugin (com.glide.messaging.awa) if you have the admin role.") * [Configure messaging actions](https://www.servicenow.com/docs/4bzgSeJqs_7GTu6MNO3e2g "Create or modify messaging actions that are performed when an event occurs. These actions apply only to messaging.") * [Enable logging for Advanced Work Assignment](https://www.servicenow.com/docs/XtAqAYgRb~TQTdpvJ6yV8g "Enable logging to monitor AWA routing and assignment.")