Workspace settings
Settings holds everything that applies to the whole workspace rather than to one agent: its name and language, your plan and credits, your team, API keys, secrets, business hours, variables and usage. Open it from Settings in the sidebar. Settings for a single agent, like its model or channels, live in that agent's pages instead.
The sections
| Section | What it's for | Who can see it | Who can change it |
|---|---|---|---|
| Workspace | The workspace name and default language, and deleting the workspace. | Everyone | Admins (deleting: owners) |
| Plan & credits | Your plan, credit balance, packages and the credit history. | Everyone (history: admins) | Nobody (read-only) |
| Members | Who can work in the workspace and their roles. | Everyone | Admins |
| API keys | Keys for calling the Peki API from your own systems. | Admins | Admins |
| Secrets | Keys your agents' tools use to call your APIs. | Editors | Editors add; admins change sites and remove |
| Business hours | Your opening hours and time zone. | Everyone | Admins |
| Variables | {{name}} values your instructions use. | Everyone | Editors |
| Usage | What used your credits in the last 30 days. | Admins | Nobody (read-only) |
On a wide screen the sections are a menu on the left; on a narrow screen they're tabs you can scroll sideways.
Workspace
"Your workspace's name and language."
| Setting | What it does | Default |
|---|---|---|
| Workspace name | The name shown in Peki, in the workspace switcher and in invitation emails. Also available to instructions as {{business.name}}. Up to 80 characters. | The name you gave when creating it |
| Default language | English or Türkçe. Used for texts the agent writes before it knows the customer's language, and for invitation emails. | Chosen when the workspace was created |
Click Save after a change. Members who aren't admins see "Only admins can change workspace settings."
The Members row below it is a shortcut to Members.
Delete the workspace
Owners see Delete workspace at the bottom. It "permanently deletes this workspace and everything in it: agents, conversations, customers, knowledge, channels, automations, secrets and API keys. This can't be undone."
- Click Delete workspace.
- Type the workspace's exact name to confirm.
- Click Delete workspace again.
Right away its agents stop answering, its channels and API keys stop working, and all of its data is deleted for every member. Peki then moves you to another workspace you belong to, or to creating a new one. For exactly what is erased, see Data and privacy.
There is no undo and no trash. If you only want to stop one agent, delete that agent instead (Delete agent in the agent's menu, admins and owners).
Plan & credits
"Your plan, credits and what used them." Shows your Plan, Credits balance and Used this month, the Packages (Coming soon, with Contact us), how credits work and, for admins, the History. See Plans and credits.
Members
"Who can work in this workspace and what they can do." Invite people by email, choose their role, change roles and remove people. See Members and roles.
API keys
"Call the Peki API from your own systems." Create Read only or Read and write keys, see when each was last used, and Revoke them. Admins only. See API keys.
Secrets
"API keys your tools use. Stored encrypted; only the last four characters are ever shown."
These are the keys for your systems, like your shop's order API, that your agents' HTTP tools and Functions send with their requests. Editors and up can open this section; others see "Only editors and admins can see this."
Secrets are grouped by agent: every key belongs to exactly one agent, and only that agent's tools can use it.
Add a secret
- Choose the Agent the key is for.
- Enter the Key name, for example "ShopX API". Up to 80 characters, unique per agent.
- Paste the key (at least 4 characters).
- Enter the Allowed sites: the host names the key may be sent to, like
api.yourshop.com, or*.yourshop.comfor all subdomains. Up to 10, separated by commas or spaces. If you paste a full address likehttps://api.yourshop.com/v1, Peki keeps only the host name. - Click Save key.
After saving, only the last four characters show (····a1B2). Nobody can read the full value back, not even admins.
Each secret shows
| Item | Meaning |
|---|---|
Name and ···· last four | Which key it is. |
| Sent only to | The allowed sites. The key is never sent anywhere else. |
| Change sites | Admins only. Changes where the key may be sent. |
| Remove | Admins only. "Tools that use this key will fail until you choose another one." |
Unassigned secrets
Keys saved before keys belonged to an agent show under Unassigned: "No tool can use them until an admin assigns them." An admin picks the agent with Assign to…. A key that already belongs to an agent can't be moved to another one; add it again for the other agent instead.
A key with no allowed site isn't sent anywhere until an admin adds one.
More about using secrets in tools: Variables and secrets.
Business hours
"Blocks set to "outside business hours" and the agent's date/time awareness use these windows." Set the Timezone and one opening window per day. Admins only. See Business hours.
Variables
"Use {{name}} in prompt blocks. Change a value here and every agent uses it right away — no publish needed."
Built in
Always available, can't be changed:
| Variable | Value |
|---|---|
{{customer.name}} | The customer's name (Inbox, or the Test panel). |
{{business.name}} | Your workspace name. |
{{today}} | Today's date in your workspace timezone. |
Your variables
Editors and up can add their own, for example {{support_phone}} with the value +1 212 555 0100, or {{return_days}} with 30.
| Field | Rules |
|---|---|
| Name | Lowercase letters, digits and _, starting with a letter, up to 40 characters. Built-in names can't be reused. |
| Value | Up to 1,000 characters. |
| Description (optional) | Up to 200 characters, a note for your team. |
Click Add variable, or Save after changing a value. Delete asks first: "Blocks that use it will get an empty value." Others see "Only editors can change variables."
See Variables and secrets for how to use variables in instructions.
Usage
"What used your credits in the last 30 days." Totals by kind, by agent and by day. Admins only. See Usage.