Configure an AI Employee
After setting the employee's identity, choose what it should do, which information it can use, and which actions it is allowed to take.
Who can do this
Owners, Admins, and users with the required AI Employees → Edit and Configure permissions can configure an employee. Your workspace role controls your access to these settings. The employee's own tool permissions are configured separately.
Open the employee configuration
- Open AI Employees → Dashboard.
- Choose Drafts or Deployed to find the employee.
- Select the employee to open its configuration.
- Use Duties and responsibilities, Knowledge base, Tools, and Guardrails to work through its setup.
Set duties and reply behaviour
- Open Duties and responsibilities.
- Write clear instructions describing the employee's job, the information it should collect, and when it should hand work to a person. You can use Write instructions with AI to help draft the instructions, then review the result.
- Under When this employee replies, choose Always or Only outside business hours.
- Under Mailbox this employee answers, choose a connected mailbox if the employee should answer email. Keep Does not answer email selected if it should not.
For example: “Answer product questions using the selected knowledge. If the answer is missing, ask a team member. Do not promise a discount.”
Choose the knowledge it can use
Knowledge Hub stores your workspace's business information. The employee's Knowledge base panel lets you select which of that information it may use.
- Open Knowledge base.
- Expand the relevant section: Business details, Products & services, Website content, Documents, or FAQ & custom.
- Check the items this employee needs. Uncheck anything it should not use. Unchecked items remain in Knowledge Hub; they are withheld from this employee.
- Use None to clear the selections in a populated section.
- If information is missing, select Open hub, a section's link, or Add in hub. Follow the Knowledge Hub guide to add or update it, then return to the employee's knowledge selection.
For a product support employee, select the relevant product information and support answers. Review those selections when your products or policies change.
Choose tools and connections
- Open Tools.
- Turn on Allow beside each tool the employee needs.
- Select Configure for that tool and complete its setup. A tool's Configure button is disabled while its access is off.
- Review the selected tools before saving.
The panel includes CRM Access, Voice, Web search, Email, Google Calendar, WhatsApp, Phone number, Attend Meetings, and AI Call. Tool access and connection setup are separate steps: allowing a tool does not by itself connect an account or assign a phone number.
Set detailed CRM permissions
- Under Tools → CRM Access, select Configure.
- Search for the area you need, or expand it in the list.
- Select the individual actions the employee needs. Use Allow all in this area only when it needs every action in that group.
- Review the permission summary, close the dialog, and select Save on the employee configuration page.
For example, the Contacts area provides these separate permissions:
| Permission | What you are allowing |
|---|---|
| View (Own) | View records within the own-record scope |
| View (All) | View records across the all-record scope |
| Create | Create contact records |
| Edit | Change contact records |
| Delete | Delete contact records |
| Export | Export contact data |
| Import | Import contact data |
| View duplicates | View duplicate-contact information |
Repeat this review for each area the employee needs. Enabling CRM Access alone does not mean every action has been granted; the configuration can still show Nothing granted yet.
To change a human team member's access to the workspace, use Roles and permissions.
Add guardrails
Guardrails describe the boundaries the employee should follow when carrying out its duties.
- Open Guardrails and review the existing rules.
- Select + Add guardrail to add a rule.
- Give it a clear name and choose its type: content_filter, policy, safety, or compliance.
- Write the rule in plain language. Explain what the employee should avoid and what it should do instead.
- Keep Enabled selected for rules you want it to use. Use Remove when that control is available and a rule is no longer needed.
- Select Save after reviewing your changes.
For example, a rule named “Pricing questions” could say: “Use the selected product information when quoting prices. If a customer requests an exception, refer the request to a team member.”
Use tool permissions to control available actions as well as guardrails to describe how the employee should behave. A written rule alone does not remove a tool permission.
Save and check your setup
- Check Status before saving so it reflects your intended setup.
- Select Save.
- Reopen the employee and review its knowledge selections, tool permissions, and enabled guardrails.
- Check that the duties describe the same work the selected knowledge and permissions support.
Troubleshooting
| What you see | What to check |
|---|---|
| A knowledge section is empty | Add the information in Knowledge Hub, then return to select it for the employee. |
| Information is in the hub but excluded for this employee | Check the item's selection in Knowledge base. |
| Configure is disabled for a tool | Check its Allow control. |
| CRM Access is allowed but no actions are granted | Open Configure and select permissions within the relevant areas. |
| The employee should answer email | Check the selected mailbox under Duties and responsibilities and the Email tool setup. |