Skip to main content
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 for the available options and 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 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 endpoint, after which the dataset appears in the agent’s dataset list.
To connect a new agent, open the Integrations page under CONNECT.