Skip to Content
Docs

Research and suggestions

How the Agent researches people and companies, how it decides what to fill in, and how you accept or dismiss what it suggests.

The Agent looks into one person or company at a time, finds evidence for its fields, and records what the evidence supports. Some findings fill a blank field straight away. Everything else becomes a suggestion that a person accepts or dismisses. Every value keeps a record of where it came from.

Before you start

The Agent must be turned on by a CRM Admin. See The Agent. Accepting and dismissing suggestions needs the CRM Editor or CRM Admin role.

What starts research

  • You ask for it. On a person or company, open the Agent panel and select Research now (or Research again). The Agent queues the record and looks at it shortly.
  • The Agent's own triggers. A CRM Admin chooses these under Settings → CRM → Agent → What starts the agent. Each is off until switched on:
    • A new contact is added
    • A new company is added
    • Tracked fields are blank: each night, shared records with blank tracked fields that the Agent hasn't looked at in the last 30 days.
    • An email to a contact bounces
    • A contact appears to have changed jobs
  • Your answers. When you answer one of the Agent's questions, it looks at the record again.
  • Named agents. Some named agents research people on a schedule.

On its own, the Agent only researches records everyone can see. A private record is researched only when its owner asks.

What the Agent looks at

  • The record itself, its logged activity, the people at a company, and the rest of your CRM.
  • Apollo, when your workspace has it connected.
  • Web search, and a few public pages: pages a search turned up, the record's own website (home, about, team, leadership and contact pages) and its LinkedIn address. In a chat, it can also open a link you type.
  • Email: meetings the person attended, and the signature in the latest message they sent to a connected Outlook mailbox. Only the last lines of that message are read, and a value is kept only if it appears word for word in them.

Text from emails, web pages and records is treated as information, never as instructions to the Agent.

How the Agent decides what to change

Each finding gets an evidence score, shown as Verified, Probable or Possible with a percentage. Then the field rules apply:

The field is...What happens
BlankFilled, if the evidence meets Evidence needed to fill a blank and Autonomy allows filling blanks
Set by a person, even one they clearedProposed for a person to accept
Kept up to date by a live syncProposed
Filled earlier by the Agent, Apollo or HubSpotReplaced only with Verified evidence; otherwise proposed
Already the same valueConfirmed, with the new evidence added

A value you dismissed is never suggested again, however it is spelled. With Autonomy set to Propose everything, the Agent fills nothing and proposes every change.

Apollo on its own counts as Probable evidence. It can fill a blank field but never replace an existing value by itself.

See where a value came from

People and companies show a Where this came from card. Each tracked field with a known source has a badge, for example:

  • Edited by a person
  • Accepted by a team member's name
  • Found by the agent
  • From Apollo, with the date, or the name of another source such as HubSpot or Outlook

Select a badge to see the evidence behind the value and its History, where each value is marked In use, Proposed, Dismissed or Replaced.

Accept or dismiss a suggestion

You can decide a suggestion in three places:

  • On the record, under Needs you in the Agent panel. Select Accept or Dismiss.
  • On CRM → Approvals, on the Proposed facts tab. Open Why to see the reason and evidence. Select several and use Accept selected or Dismiss selected to decide them together.
  • On Duplicates, on the Proposed changes tab.

An accepted value counts as a value a person typed, so the Agent won't overwrite it; it can only propose a change. If the field changed after the suggestion was made, the row says "This field changed since this was suggested. It can only be dismissed."

Your edits always win

When you edit a tracked field yourself, your value replaces whatever the Agent or a data source put there, and the field is marked Edited by a person. From then on the Agent can only propose changes to it.

Apollo enrichment

When Apollo is connected, a person's record has an Apollo button (Enrich contact with Apollo, or Enrich contact and linked company with Apollo when the person has a company), and a company has Enrich with Apollo. What Apollo returns follows the same field rules: it fills blanks, and a different existing value is either ignored or proposed, as set in When Apollo disagrees with a value.

Job changes

If a contact's email signature shows a different job title from the one on the record, the record's Agent panel notes "Their signature shows a different job title". With A contact appears to have changed jobs switched on, the Agent plans to look at that person again a week later.

Stage suggestions

For a company that has no stage yet, the Agent can suggest one, shown as The Agent's suggestion with its reason. Select Set as the suggested stage, or Dismiss. It never suggests Vendor, Partner or Former Clients, and it never sets a stage by itself. See Company stages.

Next steps

On this page