用途：本地代理是安装在你内网 Windows 或 Linux 主机上的 Celigo 软件，它主动向 integrator.io 拨出并保持连接，使平台可反向发送任务。因是出站连接，无需开放入站防火墙端口或白名单 Celigo IP，即可访问防火墙后的私有系统。注意区分：本地代理（/agents）负责连通性，Stack 负责运行自定义代码，AI agent（/aiagents）负责 LLM 处理记录，三者不同。
适用范围：目标系统无公网端点时才需要，如无公开监听的内网 SQL Server/Postgres、Oracle（仅代理模式）、本地主机目录或网络文件共享、仅内网可访问的应用。公共 SaaS API 或带公网端点的云数据库无需代理。filesystem、jdbc（agent/activedirectory）、Oracle rdbms、内网 mongodb 连接必须设置 _agentId。
使用方式：创建资源至少需 name，可加 description；create 响应返回敏感 accessToken。随后在内网主机通过 integrator.io UI 下载安装代理软件，用 accessToken 配对以建立隧道。用 celigo agents get <id> 验证 offline 为 false 且 lastHeartbeatAt 较新。常用 CLI：celigo agents list、get <id>、create、update <id>、delete <id> [-y]，以及 celigo account search "<keyword>" 查找已有代理。仅 name 和 description 可写。
限制与注意：资源只是注册，不装软件并配对则不会连接。令牌轮换会使旧令牌失效，需在主机上重新配置并重新配对，期间短暂断连，应选安静时段。accessToken 属凭据，泄露需轮换。offline 由心跳推导，主机宕机或服务停止会中断经该代理的所有连接，应修代理而非逐个改连接。Oracle 必须先安装配对代理再建连接。默认每个网络位置一个代理，增加代理用于网络分段或可用性。未提供的细节暂未说明。