> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Find your way around Hamsa Agents

> The Hamsa Agents sidebar and header, the platform and project switchers, Cmd+K search across calls, documents and tools, keyboard shortcuts and sending feedback.

Every page in Hamsa Agents has the same frame: a sidebar with the parts of the product, and a header with your project, search and a few icons. This page explains each part, how to find anything with Cmd+K (Ctrl+K on Windows), every keyboard shortcut, how to send feedback, and what the bar under the header means when your connection drops.

![Hamsa Agents on Home: the sidebar with the platform's pages, Agents and Telephony, and the header with the Customer Support project, the search field, Activity, Notifications, docs, Send feedback and the account avatar](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/agents-shell-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=5353e396617d758a5a3b6c2e49fd1deb)

## The sidebar

The sidebar has three groups. You see the pages your role lets you open.

| Item | What it opens |
| - | - |
| **Home** | [Home](https://docs.tryhamsa.com/agents/monitor/home.md): quick starts, merge requests waiting for you, your recent agents and credits. |
| **Analytics** | [Analytics](https://docs.tryhamsa.com/agents/monitor/analytics.md) for the project's calls. |
| **Voices** | [Voices](https://docs.tryhamsa.com/agents/voices/choose-a-voice.md) and [dictionaries](https://docs.tryhamsa.com/agents/voices/dictionaries.md). |
| **Conversation log** | Every call, in the [Conversation log](https://docs.tryhamsa.com/agents/monitor/conversation-log.md). |
| **Live calls** | The calls going on now. See [Live calls](https://docs.tryhamsa.com/agents/monitor/live-calls.md). |
| **API keys** | The project's [API keys](https://docs.tryhamsa.com/overview/create-api-keys.md). |
| **Secrets** | [Secrets](https://docs.tryhamsa.com/agents/tools/secrets.md) your tools use. |
| **Agents** > **Agents list** | Your agents. See [Create an agent](https://docs.tryhamsa.com/agents/build/create-an-agent.md). |
| **Agents** > **Merge requests** | Changes waiting for review, for members who review them. See [Merge requests](https://docs.tryhamsa.com/agents/release/merge-requests.md). |
| **Agents** > **Knowledge base** | The [knowledge base](https://docs.tryhamsa.com/agents/knowledge-base/overview.md). |
| **Agents** > **APIs & MCPs** | Your [tools](https://docs.tryhamsa.com/agents/tools/overview.md). |
| **Agents** > **Policies & guardrails**, **Functions & macros** | [Policies & guardrails](https://docs.tryhamsa.com/agents/safety/policies-and-guardrails.md) and [Functions & macros](https://docs.tryhamsa.com/agents/safety/functions-and-macros.md), for members who can read them. |
| **Telephony** > **Batch calls** | [Batch calls](https://docs.tryhamsa.com/agents/connect/batch-calls.md). |
| **Telephony** > **Bring your own number** | Your [phone numbers](https://docs.tryhamsa.com/agents/connect/phone-numbers.md). |

To make room, collapse the sidebar to icons with the button at the start of the header, or press Cmd+B (Ctrl+B on Windows). The flow builder opens with the sidebar collapsed. On a phone or a narrow window, the sidebar opens as a drawer from the same button.

### Switch to Hamsa Media

The Hamsa logo at the top of the sidebar is the platform switcher. Click it and pick **Media platform** ("Create content with AI") to open Hamsa Media in the same tab. **Agents platform** ("Build AI agents") is the one you're in, marked with a check.

![The platform switcher open under the Hamsa logo, with Media platform and Agents platform, Agents platform checked](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/platform-switcher-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=bd821db3288f3226406637652dcfd87c)

## The header

From start to end:

| Part | What it does |
| - | - |
| Sidebar button | Shows or hides the sidebar. |
| Project switcher | Shows the project you're in. Open it to switch project, or for **Project settings**, **Create project**, **Edit project**, **Rename label** and **Copy project ID**. |
| "Search or run a command" | Opens the [command palette](#the-command-palette). |
| **Activity** | Knowledge base documents being indexed and batch calls in progress. See [Notification settings](https://docs.tryhamsa.com/overview/account-settings/notification-settings.md). |
| **Notifications** (bell) | Merge requests, exports, credit, call, batch call, team and API key notices. See [Notification settings](https://docs.tryhamsa.com/overview/account-settings/notification-settings.md). |
| **Docs** (book) | Opens the Hamsa docs in a new tab. |
| **Send feedback** (bug) | Point at part of the page and tell the Hamsa team about it. See [Send feedback](#send-feedback). Shown where it is switched on for your account. |
| Your avatar | Your name and email, your plan and credits, **Theme**, **Language**, **Profile**, **Security**, **Notifications**, **Billing** and **Sign out**. See [Account settings](https://docs.tryhamsa.com/overview/account-settings/overview.md). |

### Switch project

Click the project's name in the header. Your projects are under **My projects** and projects you were invited to under **Invited projects**, each in alphabetical order. With more than five projects, a search field appears at the top.

![The project switcher open: Customer Support under My projects, then Project settings, Create project, Edit project and Copy project ID](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/project-switcher-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=f8a02d8fed36f913b3addf96b38a256e)

When you switch from an agent's editor, Hamsa Agents opens that project's **Agents list**. If the page has unsaved changes, you're asked first. See [Projects](https://docs.tryhamsa.com/overview/projects/overview.md) for what a project holds.

## The command palette

To search or run a command from any page, press Cmd+K on Mac or Ctrl+K on Windows, or click "Search or run a command" in the header. Type to filter, use the arrow keys to move, Enter to pick and Esc to close.

![The command palette with an empty search: Go to lists Home, Analytics, Voices, Conversation log, Live calls, API keys, Secrets, Agents list and Merge requests](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/command-palette-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=b40edb7b5f24c04dbca84e5430c5f691)

The palette lists, in this order:

| Group | What's in it |
| - | - |
| **Recent** | The last six commands you ran, kept in this browser. Shown while nothing is typed. |
| The page's own commands | Actions for the page you're on, such as **Create batch call** on Batch calls or **Copy call ID** with a call open. |
| **Go to** | Every page in the sidebar that you may open. |
| **Agents** | Every agent in the project, with its type. Picking one opens its editor. |
| **Actions** | **New agent** (if you may create agents), **Theme**, **Language** and **Keyboard shortcuts**. |
| **Inside** | While you type: choices that live inside another command, such as **Theme: dark**. |
| **Your content** | While you type: calls, knowledge base documents and tools that match. |

The palette shows only what your role lets you do. Words can come in any order; every word you type must match.

Some commands open a list of their own, such as **Theme** (**Theme: light**, **Theme: dark**, **Theme: system**) and **Language** (**Language: English**, **Language: Arabic**). The command's name appears as a chip in the search field. Press Esc, or Backspace with the field empty, to step back.

![The command palette inside Theme, with a Theme chip in the search field and Theme: light, Theme: dark and Theme: system](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/command-palette-theme-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=b2ab0ced8bf5e825e63bbe23686008c0)

### Find calls, documents and tools

Type two characters or more and the palette also searches **Your content** in the current project, up to four results of each kind. "Searching your calls, documents and tools…" shows while it looks.

| Kind | What it matches | Picking one |
| - | - | - |
| **Call** | A full call ID, a full agent ID, or the caller's phone number or part of it, typed as digits without spaces (with or without the leading +). | Opens the [Conversation log](https://docs.tryhamsa.com/agents/monitor/conversation-log.md) narrowed to that call. |
| **Knowledge base** | Document names. | Opens the [document](https://docs.tryhamsa.com/agents/knowledge-base/overview.md). |
| **Tool** | Tool names. | Opens the [tool](https://docs.tryhamsa.com/agents/tools/overview.md). |

Each result shows its kind, the call's agent where there is one, and how long ago it was made. A result you open stays in **Recent** for this project. You only see the kinds your role lets you read.

![The command palette with +97150482 typed: Your content shows one call from +971504821937 to Order Support Flow, 4 minutes ago](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/command-palette-find-call-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=b7a9747f4d1ab3a80cbab608b93f3741)

![The command palette with delivery typed: Your content shows the knowledge base document Delivery areas and times and the tool update\_delivery\_address](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/command-palette-find-content-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=0c0bb25829ba9df95d38d6d404ef307b)

### Examples of what you can type

| Type | To |
| - | - |
| `+97150` (any part of a caller's number) | Find that caller's calls. |
| A call ID | Open that call in the Conversation log. |
| `refund` | Find knowledge base documents and tools with "refund" in the name. |
| An agent's name | Open the agent's editor. |
| `dark` | **Theme: dark**. |
| `arabic` | **Language: Arabic**. |
| `shortcuts` | Open **Keyboard shortcuts**. |
| `create` (on Batch calls) | **Create batch call**. |

## Keyboard shortcuts

Press **?** on any page, except while you type in a field or with a dialog or menu open, to open **Keyboard shortcuts**. You can also pick **Keyboard shortcuts** in Cmd+K. The sheet lists the keys that work everywhere and those of the page you're on; on the flow canvas or with a call open, their keys come first.

![The Keyboard shortcuts sheet with General, Agent editor, Call details and Tables](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/shortcuts-sheet-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=a8387435568c84b9ba457894b1ce0691)

| Where | Mac | Windows | Does |
| - | - | - | - |
| Everywhere | Cmd+K | Ctrl+K | Search or run a command |
| Everywhere | ? | ? | Show keyboard shortcuts |
| Everywhere | Cmd+B | Ctrl+B | Show or hide the sidebar |
| Flow and single prompt editors | Cmd+S | Ctrl+S | Save now |
| Flow and single prompt editors | Cmd+Shift+Enter | Ctrl+Shift+Enter | Start a test call, or end it |
| Flow and single prompt editors | Cmd+Option+Enter | Ctrl+Alt+Enter | Start a test chat, or open it |
| A call open | Esc | Esc | Close the call details |
| A call open | Space or K | Space or K | Play or pause the recording |
| A call open | ← / → | ← / → | Back / forward 5 seconds |
| A call open | J / L | J / L | Back / forward 10 seconds |
| A call open | Shift+, / Shift+. | Shift+, / Shift+. | Slower / faster |
| The recording's progress bar (click it or Tab to it) | Page Down / Page Up | Page Down / Page Up | Back / forward 10 seconds |
| The recording's progress bar | Home / End | Home / End | Go to the start or the end |
| A page with a table | F | F | Filter the table |

The recording keys work the same way in Debug mode. Single-letter keys don't fire while you type in a field, or while a dialog or menu is open. Space presses a focused button instead of playing; K always plays and pauses.

With a call open, the sheet lists the recording's keys first:

![The Keyboard shortcuts sheet with a call open: Recording (Space or K, J or L, arrows, Shift with comma or period) above General, Agent editor and Call details](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/shortcuts-sheet-call-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=94a41be49f2aa9d6d693381cd98fd088)

In the flow builder, the sheet starts with **Flow canvas**: selecting, grouping (Cmd+G or Ctrl+G), copying and pasting steps, deleting, finding a step (Cmd+F or Ctrl+F), moving around and zooming. See [Flow builder](https://docs.tryhamsa.com/agents/flow/flow-builder.md).

![The Keyboard shortcuts sheet in the flow builder, with the Flow canvas section first](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/shortcuts-sheet-canvas-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=a603b38f971d03ad245ad397d5fe4567)

> [!TIP]
>
> On an Arabic keyboard layout, **؟** opens the shortcuts sheet, and the recording's letter keys work by key position (K plays and pauses).

## Send feedback

Use the bug icon in the header to tell the Hamsa team about a problem or an idea, pointing at the exact part of the page.

**1. Start**

Click **Send feedback** in the header. The first time, a card explains how to point: "Point at what your feedback is about". Click **Start**, or **Whole page instead**.

![The first-time card Point at what your feedback is about, with Whole page instead and Start](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/send-feedback-intro-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=7500c8321d1e4d89f6e0f2b8b577982a)

**2. Point at the part**

Move over the page: the part under your cursor is outlined. Click it. Press Esc or **Cancel** to stop, or click **Whole page** in the bar at the top.

![Picking a part of Home: the Start something section outlined, with the bar Click the part of the page your feedback is about, Whole page and Cancel](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/send-feedback-pick-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=2a258ad6c9a287831bb5fca6849b9d93)

**3. Write and send**

The **Send feedback** form shows what you picked (**Pick again** to change it). Write **Your feedback**, keep or switch off **Include a screenshot**, and click **Send feedback**. "Thanks, your feedback was sent." confirms it.

![The Send feedback form: the picked part, Your feedback filled in, Include a screenshot switched on with a preview of the page, and Send feedback](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/send-feedback-form-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=2849731279c003261bc26a1dbcd490fd)

The screenshot shows the screen as you see it, with the part you picked outlined and your private details blacked out: call transcripts, phone numbers, keys and anything typed in a field. The form shows the screenshot before you send it. If a screenshot can't be taken, the form says so and your feedback goes without one. Your name and email, the page you were on and your project go with the report.

## When the connection drops

A bar under the header tells you when Hamsa Agents can't reach Hamsa well:

* **"You're offline. Some things can't load or save until you're back online."** Your device has no connection. When it comes back, what's on screen refreshes by itself. Changes in the agent editors are kept on this device and save once you're back online.
* **"The connection is slow."** Several requests in a row failed or took more than 8 seconds. Click **Retry** to load what's on screen again. The bar goes away once requests answer in good time.

![The bar under the header: The connection is slow, with Retry](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/navigation/connection-slow-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=dc67949581b4c30dd304fce666ab079a)

## On-premises installations

If your organization runs Hamsa on its own servers, the frame differs in a few places: the logo doesn't switch platforms (unless your installation turns it on), there is no **Send feedback**, no **Billing** in the account menu, and the **Knowledge base** item can be hidden.

## Good to know

* In Arabic the sidebar moves to the right and pages read right to left. Switch the language from your avatar or with **Language** in Cmd+K.
* A link to a page in another project (for example from a notification) opens that project first.
* Cmd+K lists only pages that are switched on for your account and that your role lets you open.

## Related

> [card] [Home](https://docs.tryhamsa.com/agents/monitor/home.md)
>
> Quick starts, merge requests and your recent agents.

> [card] [Conversation log](https://docs.tryhamsa.com/agents/monitor/conversation-log.md)
>
> Every call, with filters and search.

> [card] [Account settings](https://docs.tryhamsa.com/overview/account-settings/overview.md)
>
> Profile, security, theme and language.

> [card] [Projects](https://docs.tryhamsa.com/overview/projects/overview.md)
>
> What a project holds and who's in it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.