Integrations

Your Settings

Your settings are where you connect the outside tools Grengin can use, and where you shape how the assistant talks to you. Open Settings, and you’ll find two tabs across the top: Integrations and Prompt Settings. On a small screen the tabs scroll sideways if they don’t all fit.

Grengin user settings

Integrations

The Integrations tab lists the servers and connectors you can plug into Grengin, like a calendar, a file store, or a search tool. Once a server is connected, the assistant can use its tools while you chat.

At the top you’ll see a quick count of how many integrations are Connected, how many are Available, and the Total.

See what’s connected at a glance

  • Use the Grid / Table toggle to switch between card view and a compact list.
    • Grid shows each integration as a card with a colored border that reflects its status.
    • Table lays everything out in rows with columns for name, transport, status, tools, when it connected, and actions.
  • Use the status filter to narrow the list to All, Connected, or Available.
  • If a filter leaves you with nothing to show, click View all to clear the filter and see everything again.

Understand the status badges

Each integration shows a status so you know whether it’s ready to use:

  • Connected — linked and ready. The assistant can use its tools right now.
  • Expired — the connection has aged out and needs renewing. You’ll see a warning, and you should reconnect before relying on it.
  • Error — something went wrong with the connection. Reconnect to try again.
  • Disconnected — not linked yet.

You’ll also see a small transport badge (such as http or sse). That just describes how Grengin talks to the server; you don’t need to do anything with it.

For a connected integration, the card shows the account it’s linked to and how long it’s been connected.

Connect a server

  1. Find the server you want and click Connect.
  2. A sign-in window opens so you can authorize your account. The button shows a spinner while it’s working.
  3. Approve access. You’ll be brought back to Grengin and the server flips to Connected.

If the connection fails, you’ll see a brief message and be returned to your settings so you can try again.

Reconnect a server

If an integration is Expired or showing an Error and isn’t working, refresh its access:

  1. Click Reconnect on that integration.
  2. Sign in and approve access again, just like the first time.

You can also reconnect a server that’s already connected if you want to re-authorize it.

View a server’s tools

Want to know exactly what an integration can do?

  1. Click the tools count on the integration.
  2. A window opens listing each tool with its name and a short description.

If the server hasn’t reported any tools, the window simply tells you the list is empty.

Disconnect a server

  1. Click Disconnect on the integration.
  2. A quick confirmation appears asking if you’re sure. Click Yes to confirm or No to back out.
  3. While it disconnects you’ll see a spinner, then the integration returns to Available.

The confirmation step is there so you never disconnect something by accident.

Prompt Settings

The Prompt Settings tab is where you see and shape the assistant’s system prompt, the underlying instructions that set its tone, focus, and behavior in your chats.

Grengin prompts user setting

See your active prompt and where it comes from

At the top, the active prompt card shows the instructions currently in effect. A badge tells you the source:

  • User custom — a prompt you wrote yourself. This is yours, and it takes priority.
  • Department default — a prompt set for your team.
  • System default — the standard prompt that ships with Grengin.

If you haven’t written your own, you’ll be using a department or system default.

Write your own prompt

  1. In the editor, type the instructions you want the assistant to follow.
  2. Use the Edit / Preview toggle to check your work:
    • Edit shows the editable text box. A character count sits at the bottom.
    • Preview shows how your prompt reads, with any variables highlighted. If there’s nothing to preview yet, it’ll tell you.
  3. Click Save when you’re happy. Save stays disabled until you’ve actually made a change, and shows a spinner while it saves.

Once saved, your prompt becomes the active one and its source shows as User custom.

Insert variables

If your prompt supports variables (like a placeholder for your name or the date), a helper card appears with a chip for each one.

  • Click a variable chip to drop it into your prompt at the cursor. It’s also copied to your clipboard, and you’ll see a brief “copied” confirmation.
  • In Preview, variables are highlighted so you can spot them easily.

If your prompt doesn’t define any variables, the helper card won’t appear.

Reset to the default

Changed your mind and want to go back to the standard prompt?

  1. Click Reset to default. This option only shows when you’re using your own custom prompt.
  2. A confirmation window appears. Click Reset to confirm, or Cancel to keep your prompt.

After resetting, your custom prompt is cleared and you go back to the department or system default.

Give feedback on the prompt

You can tell the team how well the prompt is working for you:

  1. Click the thumbs-up or thumbs-down rating. Clicking the same one again clears your choice.
  2. Optionally, add a comment with more detail.
  3. Click Submit. The button stays disabled until you’ve picked thumbs-up or thumbs-down, and shows a spinner while it sends.

Your feedback helps whoever maintains the prompts make them better over time.