Skip to main content

πŸ› οΈ Agent Settings

Agent Settings control the agent's general behavior in your server: its command prefix, its language, who can manage it, and whether it runs under your own branded Discord bot instead of the default Fren One agent.

Overview​

From this page you can:

  • Set the command prefix the agent responds to
  • Choose the agent's language for server-facing messages
  • Grant agent admin roles so trusted staff can manage the agent without holding Discord Administrator
  • Deploy a Custom Bot: the agent runs under your own bot's name and avatar
  • Set the server's Ignored Channels, the channels the agent must never read

Configuration​

To configure agent settings:

  1. Open your workspace in the Fren One webapp.
  2. In the sidebar under Channels, select the Discord server you want to configure. Its pages open beneath it.
  3. Select Agent Settings.

The page has two tabs and opens on General. General holds the guild settings card (saved together via the Save bar) and the Custom Bot card (immediate actions). Ignored Discord Channels is documented on its own page.

Guild settings​

OptionDescription
Command PrefixThe prefix for text commands. Required; up to 5 characters. Default: !.
LanguageThe agent's language. Required. Options: English, EspaΓ±ol, FranΓ§ais, Deutsch, PortuguΓͺs, Русский, δΈ­ζ–‡, ζ—₯本θͺž, ν•œκ΅­μ–΄. Default: English.

Agent admin roles​

"Agent admin roles" is a role multi-select with real reach: treat it as your agent staff list. Members with any of these roles can:

  • Manage the agent's settings from Discord, and
  • Join your Fren One workspace as verified admins: they pass the workspace's admin verification for this server without holding Discord Administrator. Someone who joins this way without a workspace role is a Channel admin (see Joining a Workspace).

That second point is the usual way to onboard staff who help run the agent but aren't Discord admins: create a role for them, grant it in Discord, and add it here. They can then verify into the workspace and use every agent configuration page for this server.

Two safeguards apply:

  • Only real Discord admins and the server owner can edit this list. Someone who gained access through an agent admin role can change the prefix and language, but the "Agent admin roles" field isn't shown to them: agent admins can't grant agent admin.
  • Adding a role with more than 15 members asks for confirmation first, spelling out how many members would gain access to the agent's settings.
Grant agent admin deliberately

Every member holding an agent admin role can reconfigure the agent and verify into your Fren One workspace as an admin of this server. Prefer a small, dedicated role over adding a broad community role.

Anything that should stay out of their reach belongs on the Ignored Channels list first. Ignored channels stay invisible to them.

Custom Bot​

The Custom Bot card runs the agent under your own branded Discord bot: your bot's name and avatar instead of ours. Paste a bot token from the Discord Developer Portal (your application β†’ Bot β†’ Reset Token) into the "Bot token" field and select "Deploy bot". The token is stored encrypted and never shown again.

Enable the privileged intents first

Your Discord application needs the Server Members and Message Content privileged intents enabled, under Bot β†’ Privileged Gateway Intents in the Developer Portal. Fren One validates the token and the intents before anything is stored, so a deploy is refused if either is missing.

Once deployed, the card shows a green "Deployed" badge with the name your bot is running as, plus a "Remove custom bot" button. Removing asks for confirmation: the agent switches back to the default Fren One bot in this server and your custom bot stops running. You can re-deploy later with a token.

How it works in Discord​

Members of agent admin roles can manage the agent's settings directly in Discord. The /botadmin command (which requires Discord Administrator) opens the Fren One dashboard, where the list is managed. Agent admins are also treated as staff by the agent's protections: for example, the word filter never actions them.

With a custom bot deployed, everything the agent does in the server (messages, embeds, moderation actions) appears under your bot's name and avatar.

Saving your changes​

The guild settings card uses a batched save: Command Prefix, Language, and Agent admin roles stay local until you select Save in the bar at the bottom of the page, and leaving with unsaved changes shows a warning. The Custom Bot card is different: "Deploy bot" and "Remove custom bot" are immediate actions (remove asks for confirmation first).

Best practices​

Managing agent access
  • Create a dedicated role (for example "Agent Admin") rather than reusing a broad staff role: the 15-member confirmation prompt is a hint you're granting too widely.
  • After adding a role here, tell those staff members to open the server in the Fren One webapp and verify: that's how they unlock the dashboard.
  • For a custom bot, enable the Server Members and Message Content privileged intents, then generate the token with Reset Token in the Discord Developer Portal right before deploying. Never share the token: it grants full control of your bot.
  • Remove a custom bot from this page, not by kicking it from the server: kicking the branded bot leaves the channel in a degraded state.
Troubleshooting

You can't see the "Agent admin roles" field?

  • It only appears for real Discord admins and the server owner. If your access comes from an agent admin role, you can edit the prefix and language but not the admin-roles list.

A staff member can't verify into the workspace?

  • Confirm they actually hold one of the configured agent admin roles in Discord (or Discord admin permissions), and that the roles were saved via the Save bar.

"Deploy bot" rejects your token?

  • Check that both the Server Members and Message Content privileged intents are enabled for your application (Bot β†’ Privileged Gateway Intents). The token and intents are validated before anything is stored.
  • Tokens are validated with Discord before being stored. Generate a fresh one via your application β†’ Bot β†’ Reset Token in the Discord Developer Portal and paste it immediately: a token is only shown once.

On this page