Repository navigation
[No QA] Add help content for company agents #105146
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
+176
−23
Merged
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
117 changes: 117 additions & 0 deletions
117
docs/articles/new-expensify/ai-agents/Create-and-Manage-Company-Agents.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,117 @@ | ||
| --- | ||
| title: Create and Manage Company Agents | ||
| description: Create AI agents that belong to your workspace or domain instead of to you, choose their workspace role, and manage them alongside other workspace admins. | ||
| keywords: [company agents, workspace agents, company-owned agents, domain agents, shared agents, agent owner, agent role, workspace admin, domain admin, create company agent, manage company agent, Owner column, new expensify] | ||
| internalScope: Audience is workspace admins and domain admins. Covers creating company agents from a workspace, choosing their workspace role, who owns and manages them, and how they differ from personal agents. Does not cover personal agents, agent rules, RuleBot, what each agent template does, or best practices for writing agent instructions. | ||
| retrievalIntent: How do I create an agent that my company owns instead of me? | ||
| contentType: task | ||
| order: 5 | ||
| --- | ||
|
|
||
| # Create and Manage Company Agents | ||
|
|
||
| Company agents are AI agents that belong to your workspace or domain instead of to you. Use them for shared work, like reviewing reports for the whole team, so the agent keeps working even if the person who created it leaves. | ||
|
|
||
| A company agent works like a personal agent. It has its own Expensify account, follows the natural-language instructions you write, and can be chatted with, edited, and Copiloted into. The difference is who owns it and who can manage it. To learn about personal agents, see [Create and Use Agents](/articles/new-expensify/ai-agents/Create-and-Use-Agents). | ||
|
|
||
| --- | ||
|
|
||
| ## Who can create company agents | ||
|
|
||
| Workspace admins can create company agents on Collect and Control workspaces. | ||
|
|
||
| **Agents** appears in the workspace menu after **Members** with a **Beta** badge. | ||
|
|
||
| --- | ||
|
|
||
| ## How to create a company agent | ||
|
|
||
| 1. In the navigation tabs (on the left on web, on the bottom on mobile), select **Workspaces > [workspace name] > Agents**. | ||
| 2. Select **New agent**. | ||
| 3. Select **Build custom agent**, or under **Or start with a template:**, find the template you want and select **Add**. | ||
| 4. Review the auto-generated profile image and **Agent name**. If needed, you can edit these later. | ||
| 5. Select **Role** and choose the agent's role in the workspace. | ||
| 6. Select **Write custom instructions** and describe what you want the agent to do. If you started from a template, review the pre-filled instructions and edit them if needed. | ||
| 7. Select **Create agent**. | ||
|
|
||
| After you select **Create agent**, you're taken directly to a direct message (DM) with the new agent. The agent also appears on the workspace's **Agents** page. | ||
|
|
||
| <!-- SCREENSHOT: | ||
| Suggestion: The workspace Agents page with the New agent button and a list of company agents with their roles | ||
| Location: How to create a company agent | ||
| Purpose: Shows where company agents are created and listed | ||
| --> | ||
|
|
||
| --- | ||
|
|
||
| ## How to choose a company agent's role | ||
|
|
||
| The agent joins the workspace as a member with the role you choose. The role controls what the agent can see and do in the workspace, the same way it does for any other member. [Learn about workspace member roles](/articles/new-expensify/workspaces/Managing-Workspace-Members). | ||
|
|
||
| - On Collect workspaces, you can choose **Workspace admin** or **Member**. | ||
| - On Control workspaces, you can also choose **Auditor**, **Guest**, **Card admin**, **People admin**, or **Payments admin**. | ||
|
|
||
| **Workspace admin** is selected by default. Choose the role with the least access the agent needs to do its job. | ||
|
|
||
| --- | ||
|
|
||
| ## Who owns a company agent | ||
|
|
||
| When you create a company agent, you don't become its owner. Instead: | ||
|
|
||
| - If you're a domain admin and your email address is on that private domain, your domain owns the agent. | ||
| - Otherwise, the workspace you created it from owns the agent. | ||
|
|
||
| You can see each agent's owner in the **Owner** column under **Account > Agents**. Personal agents show the person who owns them, workspace-owned agents show the workspace name, and domain-owned agents show the domain name. | ||
|
|
||
| --- | ||
|
|
||
| ## Who can manage a company agent | ||
|
|
||
| The admins of the agent's owner manage it: | ||
|
|
||
| - Any workspace admin can manage an agent owned by their workspace. | ||
| - Any domain admin can manage an agent owned by their domain. | ||
|
|
||
| These admins can chat with the agent, edit its instructions, Copilot into its account, and delete it. They automatically get full Copilot access to the agent's account, so you don't need to add them by hand. | ||
|
|
||
| Company agents you can manage appear in your list under **Account > Agents**, next to your personal agents. To chat, Copilot, edit, or delete one, follow the same steps as for a personal agent. [Learn how to use agents](/articles/new-expensify/ai-agents/Create-and-Use-Agents). | ||
|
|
||
| On a workspace's **Agents** page, agents you can't manage are shown dimmed, and their buttons are turned off. | ||
|
|
||
| --- | ||
|
|
||
| ## How company agents differ from personal agents | ||
|
|
||
| | | **Personal agents** | **Company agents** | | ||
| | --- | --- | --- | | ||
| | **Where you create it** | **Account > Agents** | **Workspaces > [workspace name] > Agents** | | ||
| | **Who can create it** | Any member | Workspace admins | | ||
| | **Owner** | The person who created it | The workspace or domain | | ||
| | **Who can manage it** | The owner | All workspace or domain admins of the owner | | ||
| | **Copilot on the creator's account** | Yes, with full access | No | | ||
| | **Workspace membership** | Added to workspaces like any member | Joins the workspace with the role you choose | | ||
|
|
||
| --- | ||
|
|
||
| # FAQ | ||
|
|
||
| ## Is a company agent added as a Copilot on my account? | ||
|
|
||
| No. Unlike a personal agent, a company agent doesn't get delegated access to the account of the person who created it. It works from its own account with the workspace role you chose. | ||
|
|
||
| ## What happens to a company agent if I leave the company? | ||
|
|
||
| The agent stays with its workspace or domain. The remaining workspace or domain admins can keep managing it. | ||
|
|
||
| ## Are company agents billed? | ||
|
|
||
| A company agent is a member of the workspace it's created in and is billed as a workspace member like any other member. | ||
|
|
||
| ## Why can't I see Agents in my workspace menu? | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Navigation naming violation: "my workspace menu" is not an approved term. Per HELPSITE_NAMING_CONVENTIONS.md, call it the navigation menu. Suggested: "Why can't I see Agents in the navigation menu?" |
||
|
|
||
| **Agents** appears only on Collect and Control workspaces. It's also hidden while you're Copiloting into an agent's account, because an agent can't create its own agents. | ||
|
|
||
| ## Is there an Agents page for domains? | ||
|
|
||
| No. Domain admins manage domain-owned agents under **Account > Agents**. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Navigation naming violation: "the workspace menu" is not an approved term. Per HELPSITE_NAMING_CONVENTIONS.md, the secondary menu inside a navigation tab is the navigation menu. Rewrite to reference the navigation menu (or a bolded navigation path), e.g. "In the navigation menu, Agents appears after Members with a Beta badge."