Managing Connections

The Connections page in the Cognee Cloud UI provides an overview of all agents and datasets in your workspace. Access it from the sidebar under Connections.

​

Agents tab

Lists all agent users connected to your tenant. Each agent shows:

• 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.

Select an agent to see its dataset table: which datasets it owns or has been shared with, their access level, and indexing status.

​

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 Connecting an Agent for request/response examples.

​

Share a dataset with an agent

1. Select the agent in the sidebar.
2. Click + Add dataset.
3. Choose the dataset to share and confirm.

This grants the agent read access via the dataset permissions endpoint.

​

My Datasets tab

Lists datasets owned by the authenticated user. Each row shows the dataset name, indexing status, and a Shared column with the number of agents that have access (e.g. “2 agents”). Hover the count to see which agents are listed; rows with no agent access show —.

​

Org Shared tab

Lists all datasets visible to the tenant, regardless of owner. Each row shows the dataset name, the owner (user or agent), and indexing status.