Agent Connections - AgentSystems

Agents are containerized AI applications that process requests using configured model connections.

Ways to Add Agents

There are two ways to add agents to your deployment:

Via Index Connections: Navigate to Index Connections to connect to community agent indexes, then browse and add agents from the Discover page
Direct Configuration: Manually configure agent connections when you know the exact container image details

Before manually configuring agents on this page, you need:

Model connections configured for AI providers
Registry connections for pulling agent images

Managing via UI

Navigate to Configuration → Agent Connections in the AgentSystems UI at http://localhost:3001. The UI allows you to:

Manually configure agent deployments from known container images
Edit agent settings and egress controls
Remove agent connections

Agent Configuration

Each agent deployment requires:

Field	Description	Required
`name`	Unique agent identifier	Yes
`image`	Full image reference OR	Choice of
`registry_connection` + `repo` + `tag`	Registry and image details	one
`egress_allowlist`	Allowed outbound URLs	No
`artifact_permissions`	File access controls	No

Configuration Example

Agent with restricted internet access:

agents:
  - name: web-scraper-agent
    image: docker.io/agentsystems/scraper:latest
    egress_allowlist:
      - "https://api.example.com/*"
      - "https://data.provider.com/v1/*"

Manual Configuration

Edit agentsystems-config.yml directly:

config_version: 1

agents:
  # Hello world demo agent
  - name: hello-world-agent
    image: docker.io/agentsystems/hello-world-agent:latest

  # Agent from private registry
  - name: custom-agent
    registry_connection: dockerhub_private
    repo: mycompany/custom-agent
    tag: v1.0.0

  # Agent with egress control
  - name: web-agent
    image: ghcr.io/company/agent:latest
    egress_allowlist:
      - "https://api.allowed.com/*"

After editing, restart the platform:

agentsystems restart

Agent Lifecycle

Deployment

When you add an agent to configuration:

The image is pulled from the specified registry
A Docker container is created with labels
Networking and volumes are configured

Discovery

The gateway discovers agents via Docker labels:

agent.enabled=true marks container as an agent
agent.port=8000 specifies the agent’s port

Idle Management

Agents may stop after periods of inactivity to save resources.

​Ways to Add Agents

​Managing via UI

​Agent Configuration

​Configuration Example

​Manual Configuration

​Agent Lifecycle

Ways to Add Agents

Managing via UI

Agent Configuration

Configuration Example

Manual Configuration

Agent Lifecycle