Skip to content

[No QA] Docs updates for E/A#94602 auto-add new agent as full copilot#95675

Merged
zanyrenney merged 2 commits into
mainfrom
melvin-docs-651811-agent-copilot
Jul 10, 2026
Merged

[No QA] Docs updates for E/A#94602 auto-add new agent as full copilot#95675
zanyrenney merged 2 commits into
mainfrom
melvin-docs-651811-agent-copilot

Conversation

@MelvinBot

Copy link
Copy Markdown
Contributor

Explanation of Change

App #94602 changes agent creation so that a newly created agent is now automatically sent as a full-access Copilot of its creator's account, letting it act on the creator's behalf without the user adding it as a Copilot by hand. The create screen also now shows a note explaining this before the agent is created.

The existing help article Create and Use Agents described this as an optional / manual action ("You can also add an agent as a Copilot on your own account"). This PR updates the article to reflect the new automatic behavior:

  • Intro: Clarifies that creating an agent automatically adds it as a full-access Copilot on your account, and points to Copilot: Delegated Access under Account > Security to review or remove that access.
  • How to create an Agent: Adds a step noting the on-screen note above the Create agent button.
  • What happens after you create an agent: Changes the "You can optionally add…" bullet to state the agent is automatically added as a full-access Copilot on your account.
  • FAQ: Reworks "Can I add an agent as a Copilot on my own account?" to "Is an agent added as a Copilot on my own account?" and answers that it happens automatically on creation.
  • Metadata: Updates the description to match the new behavior.

All UI labels (Copilot: Delegated Access, Account > Security, Create agent, New agent) were verified against the existing Copilot help articles and the PR's copy for exact capitalization.

Fixed Issues

$ https://github.com/Expensify/Expensify/issues/651811

Tests

// TODO: The human co-author must fill out the tests you ran before marking this PR as "ready for review"
// Please describe what tests you performed that validates your changed worked.

QA

// TODO: The human co-author must fill out the QA tests you ran before marking this PR as "ready for review".
// Please describe what QA needs to do to validate your changes and what areas do they need to test for regressions.


@yuwenmemon, please review the files changed and confirm they reflect the current behavior. Then mark this PR Ready for review.

… creator

Co-authored-by: Yuwen Memon <yuwenmemon@users.noreply.github.com>
@MelvinBot MelvinBot requested a review from a team July 9, 2026 10:27
@MelvinBot MelvinBot added the HelpDot Apply this label if the issue relates to ExpensifyHelp label Jul 9, 2026
@yuwenmemon yuwenmemon marked this pull request as ready for review July 10, 2026 04:25
@melvin-bot

melvin-bot Bot commented Jul 10, 2026

Copy link
Copy Markdown

Concierge reviewer checklist:

  • I have verified the accuracy of the article
    • The article is within a hub that makes sense, and the navigation is correct
    • All processes, screenshots, and examples align with current product behavior.
    • All links within the doc have been verified for correct destination and functionality.
  • I have verified the readability of the article
    • The article's language is clear, concise, and free of jargon.
    • The grammar, spelling, and punctuation are correct.
    • The article contains at least one image, or that an image is not necessary
  • I have verified the formatting of the article
    • The article has consistent formatting (headings, bullet points, etc.) with other HelpDot articles and that aligns with the HelpDot formatting standards.
    • The article has proper text spacing and breaks for readability.
  • I have verified the article has the appropriate tone and style
    • The article's tone is professional, friendly, and suitable for the target audience.
    • The article's tone, terminology, and voice are consistent throughout.
  • I have verified the overall quality of the article
    • The article is not missing any information, nor does it contain redundant information.
    • The article fully addresses user needs.
  • I have verified that all requested improvements have been addressed

For more detailed instructions on completing this checklist, see How do I review a HelpDot PR as a Concierge Team member?

cc @zanyrenney

@melvin-bot melvin-bot Bot requested a review from zanyrenney July 10, 2026 04:25
@melvin-bot

melvin-bot Bot commented Jul 10, 2026

Copy link
Copy Markdown

@zanyrenney Please copy/paste the Reviewer Checklist from here into a new comment on this PR and complete it. If you have the K2 extension, you can simply click: [this button]

@melvin-bot melvin-bot Bot removed the request for review from a team July 10, 2026 04:25
@yuwenmemon

Copy link
Copy Markdown
Contributor

@MelvinBot please resolve the conflicts here.

4. Review the auto-generated profile image and display name. If needed, you can edit these later.
5. Click **Write custom instructions** and describe what you want the agent to do.
6. Click **Create agent**.
6. Review the note above the **Create agent** button, which explains that the agent will be added as a full copilot of your account so it can act on your behalf.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Naming/terminology inconsistency: "full copilot" should be "full-access Copilot" to match the exact feature name and the phrasing used everywhere else in this article (lines 14, 52, 53, 57, 177). Copilot is a product feature name and must be capitalized, and the "full-access" qualifier should be used consistently. Suggested: "...added as a full-access Copilot on your account so it can act on your behalf."

@github-actions

Copy link
Copy Markdown
Contributor

HelpDot Documentation Review

Overall Assessment
This PR updates the Create and Use Agents article to reflect a product behavior change: agents are now automatically added as full-access Copilots on the creator's account, rather than optionally added. Changes are applied consistently across the description, intro, the How to create an Agent steps, the What happens after you create an agent list, and the FAQ. The messaging is accurate, and the added guidance on reviewing delegated access is helpful. A few UI-label and casing inconsistencies were introduced that should be tightened before merge.

Scores Summary

  • Readability: 9/10 - Clear, concise, and well-sequenced. New sentences flow naturally and added step 6 improves procedural clarity.
  • AI Readiness: 9/10 - Task-based headings preserved, full feature names used, metadata intact. Revised FAQ heading (Is an agent added as a Copilot on my own account) remains a valid question-word heading.
  • Style Compliance: 6/10 - A UI-label casing inconsistency was introduced (see below), conflicting with the exact-UI-terminology rule in HELPSITE_NAMING_CONVENTIONS.md.

Key Findings

  • Inconsistent UI label casing (must fix): The diff introduces the section label with capital Access (Copilot: Delegated Access) in the description, intro, and FAQ answer, while other lines use lowercase access (Copilot: Delegated access). Per the Core UI Referencing Rules, the label must match the product UI exactly and be used consistently. Pick one and apply everywhere.
  • Inconsistent Copilot term: New step 6 says full copilot (lowercase c) while the rest of the article uses full-access Copilot. Standardize on full-access Copilot.
  • Navigation phrasing: The Account then Security path is understandable, but consider aligning with the bolded breadcrumb-path convention used elsewhere in the docs.
  • Positives: The optional-to-automatic behavior change is applied consistently across intro, steps, post-creation list, and FAQ. Anchor text improved from add a Copilot to manage Copilot access, better reflecting real search intent and the linked article scope. Cross-links remain relative and follow the anchor-text standards.

Recommendations

  • Standardize the section label to the exact UI casing across all four occurrences.
  • Change full copilot in step 6 to full-access Copilot to match the rest of the article.
  • Optionally align the Account then Security path with the bolded breadcrumb-path style.

Files Reviewed

  • docs/articles/new-expensify/ai-agents/Create-and-Use-Custom-Agents.md - Accurate, well-written behavior update; needs minor UI-label casing/terminology consistency fixes.

Note: Detailed line-by-line feedback has been provided as inline comments.

…ent-copilot

Co-authored-by: Yuwen Memon <yuwenmemon@users.noreply.github.com>

# Conflicts:
#	docs/articles/new-expensify/ai-agents/Create-and-Use-Custom-Agents.md
@MelvinBot

Copy link
Copy Markdown
Contributor Author

🤖 Resolved the merge conflicts and pushed the merge commit — the PR is now mergeable.

The only conflict was in docs/articles/new-expensify/ai-agents/Create-and-Use-Custom-Agents.md. main had independently landed an overlapping edit to the same lines (an alternate, slightly less complete phrasing of the same "auto-add agent as Copilot" behavior), which is what caused the conflict.

I resolved all four conflict hunks by keeping this PR's more complete wording, since it's the more accurate and internally consistent version:

  • Uses full-access Copilot consistently (matching the untouched line You're automatically added as a full-access Copilot on the agent's account).
  • Names the Create agent button in the create-steps note.
  • Points to the Copilot: Delegated Access section under Account > Security and keeps the Learn how to manage Copilot access link.

I also kept the one genuinely useful clarification that only existed on main — the "You don't need to add it by hand." sentence in the FAQ answer.

yuwenmemon please give the resolved doc a quick look to confirm the wording reflects the current behavior, then mark the PR Ready for review.

@github-actions github-actions Bot changed the title Docs updates for E/A#94602 auto-add new agent as full copilot [No QA] Docs updates for E/A#94602 auto-add new agent as full copilot Jul 10, 2026
@OSBotify

Copy link
Copy Markdown
Contributor

A preview of your ExpensifyHelp changes have been deployed to https://0ded5be0.helpdot.pages.dev ⚡️

Updated articles:

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a679eb486c

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Every agent has its own Expensify account. You can Copilot into the agent's account to review its activity, update its instructions, and see the actions it has taken.

When you create an agent, it's automatically added as a full Copilot on your own account. This gives the agent delegated access to your account so it can use your personal context and manage expenses and reports on your behalf, while continuing to operate from its own account.
When you create an agent, it's automatically added as a full-access Copilot on your own account. This gives the agent delegated access to your account so it can use your personal context and manage expenses and reports on your behalf, while continuing to operate from its own account. You can review or remove this access at any time in the **Copilot: Delegated Access** section under **Account > Security**.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Point users to Account > Copilot

The Copilot delegated-access section is not under Account > Security in the current app/help flow: the route is settings/copilot (src/ROUTES.ts) and the existing Copilot article directs add/remove actions through Account > Copilot. With this path, users trying to review or remove the automatically added agent access will be sent to the wrong settings page; the same incorrect breadcrumb is repeated later in this article.

Useful? React with 👍 / 👎.

@zanyrenney zanyrenney merged commit 086f3e3 into main Jul 10, 2026
24 checks passed
@zanyrenney zanyrenney deleted the melvin-docs-651811-agent-copilot branch July 10, 2026 11:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

HelpDot Apply this label if the issue relates to ExpensifyHelp

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants