Skip to main content

Connectivity

The Connectivity screen is your tenant's registry of integrations — the connections between Flametree and the external services your AI agents rely on: language models, speech services, tools, and databases. You create a connection once, then use it from any number of agents — open the screen from Settings > Connectivity in the left menu.

Use it to:

  • Set up a tenant for the first time with a working LLM connection.
  • Connect your own model endpoint, provider account, or API keys.
  • Check whether an existing connection is healthy.
  • Choose which connection agents use by default.
Channels are managed separately

Messaging and voice channels (web widget, WhatsApp, Telegram, and so on) are connected on Settings > Channels, not here.

Before you start​

  • You are signed in to the portal. Adding and editing connectors requires the corresponding permission — if the Add button is disabled, ask your administrator.
  • You have the credentials for the service you want to connect. For an LLM, that is the API URL, an access token, and the model name from your provider.

Find your way around​

The screen has three panels, left to right:

  1. Integration categories (left) — collapsible groups of integration types: AI Models, MCP, CRM Integrations, Open API, Utility Integrations, and Deprecated Integrations. Types under Deprecated Integrations are kept for backward compatibility and marked DEPRECATED — don't use them for new setups.
  2. Connectors (center) — the connections created for the selected type. Filter the list with the search box (Enter connector name or property value), or click Add to create a new connector.
  3. Details (right) — opens when you add or select a connector and shows the editable form. The panel header reads New connector while you create and Details while you edit.

A connector is one configured instance of an integration type. You can create several connectors of the same type — for example, two LLM connectors that point to different providers — and choose per agent which one to use.

In the Connectors panel, move between cards with the Up and Down arrow keys, press Enter to open the selected connector, and press Escape to close the details panel.

Read a connector card​

Each card in the Connectors panel shows:

  • Status dot — a colored dot next to the name; hover over it to read the latest status message, including the error text if a check failed. See Check integration status.
  • Name and description — the values you entered.
  • Tags — DEFAULT for the default connector of its type, SYS.INT. for a system integration provided with the platform. See Default vs custom integrations.
  • Linked agents — the agents currently using this connector. Click an agent name to open it in a new tab; long lists collapse behind +N more.
  • Key parameters — a quick view of the main non-secret parameter values.

Default vs custom integrations​

Connector cards can carry two tags that are easy to confuse:

TagWhat it means
SYS.INT.A system integration — pre-configured and maintained by the platform, shared with your tenant. Its parameters cannot be edited.
DEFAULTThe default connector of its integration type in your tenant. Agents use the default unless a different connector is selected for them.

A connector can carry both tags, one of them, or neither — any connector, system or custom, can be made the default.

AspectSystem integrationsCustom integrations
ConfigurationPre-configured for youCreated and configured by you
AvailabilityReady as soon as you get platform accessMust be set up first
EditabilityParameters cannot be edited from your tenantFully editable
CredentialsPlatform accountYour own provider account and keys

System integrations are the quick start: use them while you evaluate the platform or when the standard configuration meets your needs. Create custom integrations when you have your own provider account, endpoint, or model deployment, need specific configuration values, or want usage billed to your own account.

note

If you try to save changes to a system integration, the portal shows Changes to system integrations can only be made in the public tenant. The only thing you can change on a system integration is its Make default state. The connector form also shows a System integration switch — it is meant for platform operators; leave it off.

Add an LLM integration​

Every AI agent needs a Large Language Model (LLM) connection — the model that understands customer messages and generates replies. The LLM type connects any model behind an OpenAI-compatible API: OpenAI, Azure OpenAI, Mistral, DeepInfra, a self-hosted model, and others.

  1. Go to Settings > Connectivity.

  2. In the left panel, open AI Models and select Large Language Model (LLM).

  3. Click Add. The New connector panel opens.

  4. Fill in the fields:

    FieldRequiredDescription
    NameYesA name for the connector, unique within your tenant — for example, OpenAI gpt-4o prod.
    DescriptionNoWhat the connector is for and who owns the account.
    API URLYesThe OpenAI-compatible base URL of the provider — for example, https://api.openai.com/v1 for OpenAI or https://api.deepinfra.com/v1/openai for DeepInfra.
    Access TokenYesThe API key issued by the provider. Stored as a secret and shown masked after saving.
    Model NameYesThe model identifier exactly as the provider expects it — for example, gpt-4o.
    TemperatureYesHow creative the replies are. See Choose a temperature.
    JSON paramsNoAdditional model parameters as a JSON object, passed to the provider with each request — for example, {"max_tokens": 1024}. Which keys are supported depends on your provider; leave it empty if unsure.

  5. Optional: turn on Make default so agents use this connector when no other one is selected.

  6. Click Save.

The portal confirms with Integration created successfully, and the connector appears in the Connectors list. Flametree then tests the connection by sending a real request to the model — once the check completes, the card shows a green status dot. Hover over the dot to read the status message.

Other integration types — embedding models, visual language models, speech-to-text, text-to-speech, transcription, MCP tools, OpenAPI tools, Intercom, mail, and databases — are also available and follow the same pattern: select the type, click Add, complete the type-specific form, and save.

Choose a temperature​

ValueModel behavior
0.0Accurate and deterministic. Best for support agents and anything fact-based.
0.7Balanced between accuracy and creativity — works for most conversational agents.
1.0Highly creative and less predictable. Suited to brainstorming and marketing copy.
tip

Start with a low temperature (0 to 0.3) for customer-support agents and raise it only if replies feel too rigid. Use values your model provider documents.

Check integration status​

Flametree tests connections that support health checks by making a real call to the service. The result is shown as a dot on the connector card:

DotStatusMeaning
GreenHealthyThe last test call succeeded.
RedUnhealthyThe last test call failed. Hover over the dot to see the error.
No dotNot checkedRequired parameters are missing, or this integration type is not health-checked.

Health checks run for Large Language Model (LLM), Visual Language Model (VLM), Embedder, Speech-to-text (STT), and Transcriptor connectors. Checks repeat periodically in the background, and the screen updates automatically.

Edit, delete, or set the default​

Edit a connector​

  1. Select the connector card. The Details panel opens with the form.
  2. Change the values you need. Secret fields such as Access Token show masked values — leave them untouched to keep the stored value, or type over them to replace it.
  3. Click Save.

System integrations (SYS.INT.) cannot be edited — create a custom connector of the same type with your own values instead.

Set a connector as the default​

  1. Select the connector card.
  2. In the Details panel, turn on Make default.
  3. Click Save.

The card now shows the DEFAULT tag, and the previous default of the same type loses it — there is one default per integration type in a tenant.

Delete a connector​

  1. Check the Linked agents list on the card — deleting a connector removes it from every agent it is linked to.
  2. Select the connector and click the delete (trash) button in the Details panel.
  3. Confirm the deletion.
warning

Deleting an LLM connector that agents use leaves those agents without a model — they stop responding until another LLM is attached. Re-link the agents first.

Common issues​

  • Red status dot after saving. The service rejected the test call. Hover over the dot to read the provider's error, then check: API URL is the base URL and usually ends with /v1 (don't include /chat/completions); Access Token is valid, active, and has quota left; Model Name matches the provider's identifier exactly, including dots and dashes.
  • No status dot. For an LLM connector, one of API URL, Access Token, or Model Name is missing — the connection isn't tested until all three are set. Some integration types are never health-checked.
  • Integration with name ... already exists. Connector names must be unique within your tenant. Pick a different name.
  • Changes to system integrations can only be made in the public tenant. Connectors tagged SYS.INT. are managed by the platform; you can only change their Make default state. Create a custom connector with your own values instead.
  • The Add button is disabled. Your role doesn't include the permission to add connectors. Ask your administrator.
  • The DEFAULT tag didn't move. The default is set per integration type. Turn on Make default on the new connector and save — the tag is released from the previous default automatically.
  • Agent replies fail although the dot is green. The health check validates the connection, not your quota for sustained traffic. Check rate limits and billing on the provider's side.

Was this article helpful?