Conectores
Un conector es la forma en que un agente llega a uno de los sistemas de tu empresa. Cada conector da a los agentes a los que se asigna un conjunto de herramientas — buscar en un buzón, consultar un pedido, crear un registro —, y el agente usa esas herramientas mientras trabaja en una tarea, igual que usa el navegador de su computadora.
Tú mismo añades los conectores. Abre Conectores desde la barra lateral: tus propios conectores aparecen arriba, y Añadir un conector más abajo ofrece conectores listos que AptiveAI aloja y mantiene al día. Elige uno, inicia sesión y ya es tuyo; luego tu equipo decide qué agentes pueden usarlo.
Añadir un conector
Sección titulada «Añadir un conector»Añadir un conector muestra lo que ofrece como una sola cuadrícula de mosaicos, con un cuadro de búsqueda. El cuadro sugiere las categorías de abajo; Mostrar u Ocultar una reduce los mosaicos:
| Categoría | Conectores |
|---|---|
| Correo y calendario | Outlook, Gmail, Google Calendar |
| Archivos y documentos | Google Drive, OneDrive, DocuSign |
| Mensajería | Microsoft Teams, Slack, Twilio SMS, Telegram, AptiveAI Messaging |
| Seguimiento del trabajo | Trello |
| Avanzado | Servidor MCP personalizado, API HTTP y el mosaico Flujo de navegador, que empieza uno nuevo |
Los flujos de navegador que creó tu equipo, o que AptiveAI publicó para tu empresa, van primero en la cuadrícula, antes de cualquier categoría.
Al hacer clic en uno se abre un panel con lo que hace, las herramientas que trae y cómo inicia sesión. Un conector alojado inicia sesión con el propio proveedor — Iniciar sesión con Microsoft, Google o Slack, donde la página del proveedor te pide elegir la cuenta y AptiveAI nunca ve tu contraseña — o toma un token o una clave que pegas (Trello, Telegram, Twilio SMS). El panel también pide:
- Nombre — opcional. Se muestra en sus etiquetas como “Outlook · Trabajo”; si lo dejas en blanco, el conector toma el nombre de la cuenta. Conecta una segunda cuenta del mismo tipo para tener dos.
- Quién puede usarlo — Cambiar… abre el cuadro para compartir. Empieza en privado; Todos en ‹espacio de trabajo› es para propietarios y administradores.
- Espacio de trabajo — solo si estás en más de uno: dónde vive el conector. Se elige tu espacio de trabajo principal, salvo que elijas otro.
Conectar lo termina, y las herramientas del conector se leen del servicio. Los propietarios y administradores pueden añadir un conector para todo el espacio de trabajo; cualquier persona puede añadir uno para sí misma.
Para que los agentes envíen textos o correos a personas que no usan AptiveAI Agents — conductores, clientes, proveedores —, un propietario de tu empresa activa AptiveAI Messaging, un conector que AptiveAI opera por ti: el correo está incluido en tu plan (hasta 250 al día) y los mensajes de texto se cobran a la billetera de tu empresa.
Tipos de conector
Sección titulada «Tipos de conector»| Tipo | Qué conecta |
|---|---|
| Conectores alojados | Los servicios listos de arriba. AptiveAI aloja el conector y su servidor, y mantiene sus herramientas al día — consulta Versiones del servidor |
| Servidor MCP personalizado | Cualquier servidor que hable el Model Context Protocol por Streamable HTTP — uno oficial de un proveedor o uno de código abierto. Sus herramientas se leen del servidor al conectarlo |
| API HTTP | Cualquier API descrita por un documento OpenAPI 3: una herramienta por operación |
| Flujo de navegador | Un sitio web sin API, que se les enseña a tus agentes una sola vez — consulta Flujos de navegador |
Servidor MCP personalizado
Sección titulada «Servidor MCP personalizado»Dale un Nombre, la URL del servidor y la Autenticación que usa:
ninguna, una clave de API enviada como Authorization: Basic,
Authorization: Bearer o un encabezado personalizado, o El inicio de sesión
del propio servidor, para el servidor alojado de un proveedor que te envía a su
página de inicio de sesión. Un servidor que no indica cómo iniciar sesión, que no
se sirve por https o que no cumple los requisitos de seguridad del inicio de
sesión se rechaza con un mensaje que dice cuál es el motivo.
API HTTP
Sección titulada «API HTTP»Un conector de API HTTP se construye a partir de la propia descripción de la API.
Su esquema viene de una URL del documento (que se descarga por https y debe
ser accesible sin credencial) o de un documento Pegado en JSON o YAML — el
formato se detecta solo. El conector llama a la API en su URL base (el primer
servidor del documento si se deja en blanco), y se autentica con una clave de
API enviada como Authorization: Basic, Authorization: Bearer o un
encabezado personalizado, o sin autenticación.
Al conectar, cada operación se importa como una herramienta. Cuando la API cambia, el conector se vuelve a importar y sus herramientas se reclasifican.
Lecturas, escrituras y aprobación
Sección titulada «Lecturas, escrituras y aprobación»Cada herramienta es una lectura o una escritura. Una lectura se ejecuta en cuanto el agente la llama. Una escritura — cualquier cosa que cambie algo en tu sistema — detiene la tarea y pregunta antes.
Cómo se clasifica una herramienta, en este orden:
- Gana una elección hecha a mano en el conector (se muestra como Fijado a mano).
- Si no, decide la marca propia del documento de la API para una operación con consecuencias.
- Si no, decide el método HTTP:
GET,HEAD,OPTIONSyTRACEson lecturas; todo lo demás es una escritura.
Cuando el agente llega a una escritura, la tarea muestra una tarjeta de aprobación — Este agente está a punto de cambiar algo en un sistema conectado, así que te está esperando — que indica el conector, la herramienta y lo que va a enviar. Respondes con:
| Botón | Efecto |
|---|---|
| Aprobar | Ejecuta esta llamada una vez y sigue |
| Aprobar todo | Ejecuta esta y deja de preguntar durante el resto de esta tarea |
| Rechazar | Omite esta llamada y dile al agente por qué — la tarjeta tiene un cuadro para indicar qué hacer en su lugar |
Cuánto puede hacer una tarea antes de preguntar es su nivel de aprobación.
Aprobar una escritura en un conector cubre todas las escrituras posteriores en ese mismo conector durante el resto de la tarea, no solo esa operación.
Ids que el agente no inventó
Sección titulada «Ids que el agente no inventó»Un conector revisa cada id que un agente le pasa — un id de mensaje, un número de pedido. El id tiene que ser uno que el propio conector haya devuelto antes en la misma tarea, o uno que una persona haya escrito en la conversación. Cualquier otro no se envía, y se le dice al agente que vuelva a buscar el id. Esto evita que un agente actúe sobre un id que adivinó o escribió mal.
Archivos que devuelve un conector
Sección titulada «Archivos que devuelve un conector»Cuando un conector responde con un archivo, o con un resultado demasiado grande para entregárselo entero al agente, el archivo se guarda con la tarea y el agente recibe su ruta y una vista previa. Luego puede abrirlo o procesarlo en su computadora como cualquier otro. Los límites de tamaño y cuánto tiempo se conserva un archivo así están en Archivos.
Los datos nunca se cortan por la mitad
Sección titulada «Los datos nunca se cortan por la mitad»Lo que devuelve un conector llega al agente entero, o se le dice que no llegó:
- Un resultado grande se conserva como archivo en lugar de recortarse, y el agente lee del archivo lo que necesita.
- Saca totales y recuentos de los propios datos, con código, en lugar de volver a teclear cifras o sumarlas de cabeza.
- Si una parte de un resultado no se pudo conservar, se le dice al agente — y se le impide enviar nada que dependa de ella. Lo que ves en la transcripción se describe en Cuando los datos de un conector llegan incompletos.
El detalle, incluido cómo vuelve un archivo que necesitas más tarde, está en Archivos que devuelve un conector.
| Estado | Qué significa |
|---|---|
| Conectado | Funciona. Los agentes a los que se asigna pueden usarlo |
| Reconectar | Se rechazó su inicio de sesión o su clave. Usa Vuelve a iniciar sesión (o Introduce una clave nueva) en su panel; los agentes que lo usan fallan hasta entonces, y se avisa al espacio de trabajo |
| No disponible | No se pudo llegar al sistema. Se vuelve a probar automáticamente cada vez que empieza una tarea |
| Sin conectar | Añadido, pero todavía sin conectar |
Un error del servidor o una sola llamada fallida no marca un conector como que necesita reconexión — solo lo hace un inicio de sesión o una clave rechazados. Un conector creado a partir de un flujo de navegador muestra en cambio un error cuando su flujo se eliminó o ya no está disponible para tu empresa.
Cuando empieza una tarea mientras un conector está averiado, sus herramientas se retienen para esa tarea y la transcripción indica cuántas herramientas asignadas no están disponibles.
Versiones del servidor y Actualizar herramientas
Sección titulada «Versiones del servidor y Actualizar herramientas»Un conector alojado funciona en un servidor que AptiveAI mantiene, y ese servidor se publica de vez en cuando. Su versión se muestra junto a alojado por AptiveAI en la entrada del conector — por ejemplo v0.1.1 — con el día en que se desplegó.
Una conexión conserva las herramientas que leyó cuando la conectaste. Cuando el servidor avanza, el panel del conector se lo dice a quien lo administra: El servidor de Outlook se actualizó a v0.1.2. Las herramientas de esta conexión pueden ser de una versión anterior. Revisa sus herramientas para incorporar los cambios. — o, si es una reconstrucción de la misma versión, …se volvió a desplegar el ….
Actualizar herramientas vuelve a leer las herramientas del servidor y muestra qué cambiaría — herramientas Nuevas, Eliminadas o Modificadas (su descripción, nombre, entradas, paginación, o si leen o escriben) — o Las herramientas guardadas ya coinciden con el servidor. No cambia nada hasta que pulsas Aplicar cambios; si el servidor cambió mientras revisabas, primero se te muestra la comparación nueva. Un agente al que se asignó una herramienta eliminada ya no puede llamarla. Una herramienta nueva que escribe se marca escribe, pide aprobación.
La página Conectores
Sección titulada «La página Conectores»La lista muestra cada Conector con su Estado, quién puede usarlo (Acceso) y quién lo creó (Creado por), con un cuadro de filtro. Quien está en más de un espacio de trabajo tiene además una columna Espacio de trabajo y un filtro Espacio de trabajo, para acotar la lista a uno.
Haz clic en un conector para abrir su panel:
- Creado por — quién lo añadió y dónde vive.
- Ajustes — para un conector que los tiene, como la dirección del sitio de un flujo de navegador.
- Herramientas — cada una marcada como lectura o como Escribe: pide aprobación (Fijado a mano cuando alguien lo eligió así), con las herramientas que puede usar cada agente.
- Lo usan — cada agente al que se asignó, y si la asignación está Activado o Desactivado. Un agente eliminado conserva su asignación y aparece al final con una insignia Eliminado, de modo que al recuperarlo vuelve equipado. Las asignaciones se cambian en el editor del propio agente, no aquí.
- Quién puede usarlo — el cuadro para compartir.
- Acciones: Nombre…, Probar conexión (Comprueba que sigue respondiendo), Vuelve a iniciar sesión o Introduce una clave nueva, Desconectar (Lo quita para todos los que lo usan) y, para el conector de un flujo de navegador, Editar flujo de navegador.
Probar conexión muestra si Funciona o No funcionó, qué se hizo, cuánto tardó y cuántas herramientas encontró, y qué hacer a continuación cuando falla.
Un conector que puedes usar pero no cambiar muestra Puedes usar este conector. Solo alguien que pueda editarlo puede cambiarlo.
Disponible para agentes personales
Sección titulada «Disponible para agentes personales»Cada conector tiene un interruptor Disponible para agentes personales. A un agente personal solo se le pueden asignar conectores que lo tengan activado. Al desactivarlo, el conector se les quita a todos los agentes personales en su siguiente tarea; las asignaciones se conservan, así que al volver a activarlo se restauran.
Quién puede hacer qué
Sección titulada «Quién puede hacer qué»| Acción | Quién |
|---|---|
| Ver un conector, su estado y sus herramientas | Las personas con quienes se comparte, y su propietario |
| Añadir un conector para ti | Todos |
| Añadir un conector para todo el espacio de trabajo | Propietarios y administradores |
| Cambiar su nombre, sus ajustes o su inicio de sesión, probarlo o desconectarlo | Quien pueda editarlo: su propietario y las personas con quienes se comparte como editoras |
| Asignar un conector a un agente | Propietarios y administradores |
| Activar o desactivar Disponible para agentes personales | Propietarios y administradores |
| Crear, cambiar, publicar o eliminar un flujo de navegador | Consulta esa página |
Asignar un conector es también una de las acciones que requieren acceso de pago.