AgentConnectors¶

class AgentConnectors[source]¶

Bases: ABC

Abstract base class for AgentApp connector execution.

Methods

call(tool_call)

Execute one model function_call and return a function_call_output item.

get_connections()

List the current Space agent's connections without credentials.

tools(names[, refresh])

Return model-facing schemas for static and discovered connector tools.

abstract call(tool_call: JSONObject) → JSONObject[source]¶

Execute one model function_call and return a function_call_output item.

get_connections() → list[JSONObject][source]¶

List the current Space agent’s connections without credentials.

Returns:

Connection metadata with connector_id, connector_ref, display_name, and description.

Return type:

list[JSONObject]

Raises:

NotImplementedError – If the session does not support agent-owned connections.

abstract tools(names: Sequence[str], refresh: bool = False) → list[JSONObject][source]¶

Return model-facing schemas for static and discovered connector tools.

Parameters:
  • names (Sequence[str]) – Connector references to include, in order.

  • refresh (bool (default: False)) – Rediscover the selected dynamic connectors. Schemas are otherwise cached for this agent runtime; static connectors require no discovery.

Returns:

Independent copies of the model-facing tool schemas.

Return type:

list[JSONObject]

Notes

Space sessions include only agent-owned connections and built-ins. Their credential-backed tool names identify a connection; pass those names unchanged to call.