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

# Managing Connections

> View connected agents, manage datasets, and share data across your workspace

To connect an agent to your workspace, open the **Integrations** page under **CONNECT** in the sidebar (route `/integrations`). It walks you through the connect flow for each supported framework. See [Integrations](/cognee-cloud/ui/integrations) for the available options and [Sessions](/cognee-cloud/ui/sessions) to review agent activity.

This page covers the connection concepts that apply once an agent is connected: its identity, status, and how to share datasets with it.

## Connected agents

Each agent user connected to your tenant has:

* **Agent type** — The framework or integration name (e.g., LangGraph, CrewAI).
* **Status** — `LIVE`, `INACTIVE`, or `NEVER_CONNECTED`. Status is computed from the agent's most recent activity, not from the presence of an API key.
  * `LIVE` — the agent has produced activity (data added, data accessed, or a search query) within the last 30 minutes.
  * `INACTIVE` — the agent has activity on record, but the most recent event is older than 30 minutes.
  * `NEVER_CONNECTED` — the agent user exists (and may even have an API key) but has no recorded activity yet.
* **Datasets** — Number of datasets the agent has access to.
* **Last active** — Timestamp of the agent's most recent activity, derived from the latest data ingestion, data access, or search query. Empty for agents in `NEVER_CONNECTED` state.

### Connection identity

Each connection is identified by an `agent_session_name` chosen by the agent. The server combines that name with the authenticated user's ID to derive the underlying connection ID, so the same `agent_session_name` always resolves to the same connection for a given user. The connection API response includes this `agent_session_name` so clients can match rows and details back to the session name they registered.

To inspect connections for the currently authenticated user without knowing the agent ID, call **`GET /agents/connections/me`** (optionally filtered by `?agent_session_name=<name>`). See the [Cloud SDK](/cognee-cloud/connections/cloud-sdk) reference for request/response examples.

### Share a dataset with an agent

You can give a connected agent read access to a dataset you own. This grants access via the [dataset permissions](/cognee-cloud/functionality/permissions-and-access-control#dataset-permissions) endpoint, after which the dataset appears in the agent's dataset list.

<Info>
  To connect a new agent, open the [Integrations](/cognee-cloud/ui/integrations) page under **CONNECT**.
</Info>