Nota: Operator está incluido como parte del complemento Pro. Necesitará el complemento Pro para usarlo.

Configurar un Data Connector generalmente significa leer la documentación de API y completar cada campo manualmente. Con Operator, describe lo que Fin necesita buscar o actualizar, y Operator crea un nuevo conector o repara uno que no funciona. Use este artículo para aprender qué puede configurar Operator, cómo revisar y probar sus propuestas, y las limitaciones a tener en cuenta.

Cada cambio llega como una propuesta. Usted la revisa, aprueba cada llamada de prueba y decide si publicarla o guardarla como borrador. Operator no puede cambiar un conector ni llamar a una API por sí solo.

Nota: Para chatear con Operator necesita el permiso Can access Fin Operator. Para aplicar un cambio en un conector también necesita el permiso Fin AI Agent & Automation y Can manage data connectors and authentication tokens.

Si es nuevo en Data Connectors, comience con Agregar Data Connectors para Fin AI Agent.

Cómo construir o reparar un Data Connector con Operator

Todo el proceso ocurre en un chat de Operator, desde la primera solicitud hasta el conector publicado.

Paso 1: Pida a Operator

En un chat de Operator, describa lo que Fin necesita. Por ejemplo:

“Cree un conector que busque un pedido de Shopify por su número.”
“Fin sigue diciendo que no puede encontrar el pedido. ¿Puede reparar el conector Get Order?”

Paso 2: Operator investiga

Antes de proponer algo, Operator puede buscar cosas en su espacio de trabajo:

Busque sus conectores y lea la configuración completa de cada uno.
Lea la respuesta de prueba guardada de un conector o la respuesta simulada.
Vea qué workflows y procedimientos usan un conector.
Revise las tasas de éxito recientes y el historial de ejecuciones. Ve el estado y el tiempo, no lo que se envió o recibió.
Enumere los atributos que puede usar en la solicitud o como objetivos de mapeo.
Enumere sus tokens de autenticación por nombre y tipo. Nunca ve el secreto.

Paso 3: Revise la propuesta

La propuesta aparece en el chat como una tarjeta Data connector.

El encabezado muestra el nombre del conector y una insignia New, Live, Draft o Paused. Un cambio de nombre muestra el nombre antiguo tachado.
API muestra el método, URL, entradas de datos, encabezados, carga útil, prueba y tokens de autenticación.
Data muestra los campos de respuesta, código Python y mapeos de objetos.
Fin muestra el prompt que Fin lee y la audiencia.
Security muestra la configuración de autenticación del cliente.
Para una edición, la tarjeta muestra qué cambia respecto a la versión en vivo. Las secciones sin cambios comienzan colapsadas, y cada sección muestra cuántas líneas se agregaron y eliminaron.
Los tokens de autenticación se muestran solo por nombre.

Paso 4: Apruebe la prueba

Antes de ejecutar una prueba, Operator muestra una tarjeta titulada Test “nombre del conector” con los valores que enviará.

Revise los valores. Nada se envía hasta que haga clic en Run test. Cancel lo detiene.
La prueba llama a la API real. El resultado aparece como, por ejemplo, “Prueba aprobada (HTTP 200)” o “Prueba fallida (HTTP 401)”.
Operator lee la respuesta y la usa para configurar los campos de respuesta.

Operator también puede hacerle a Fin una pregunta de prueba en una conversación previa, como lo haría un cliente. Esto muestra si Fin selecciona el conector y cómo usa la respuesta. En una vista previa, Fin responde como si los cambios pendientes del conector en el chat ya se hubieran aplicado, y usa la respuesta de prueba guardada o simulada en lugar de llamar a la API.

Importante: Las pruebas envían solicitudes reales al sistema conectado. Si un conector crea, actualiza o elimina datos, probarlo realiza ese cambio. Use registros de prueba. Operator solicita su aprobación antes de cada prueba.

Paso 5: Aplique el cambio

Usted elige cómo se aplica el cambio:

En un conector en vivo, el botón principal es Publish. Save as draft (o Update draft, si existe un borrador) está en el menú.
En un conector nuevo, borrador o pausado, el botón principal es Save as draft (o Update draft). Publish está en el menú.
Publish pregunta “¿Listo para publicar?” primero. Permanece deshabilitado hasta que la prueba de Operator haya pasado, a menos que el conector use una respuesta simulada. Una edición que no cambia la solicitud (URL, método, encabezados, cuerpo, entradas y tokens de autenticación) mantiene la prueba aprobada anterior del conector.
Una eliminación muestra un botón rojo Delete y una advertencia de que no se puede deshacer.
El icono de la papelera (Discard change) descarta la propuesta.
Apply all aplica todos los cambios en el chat. Un conector nuevo se guarda como borrador, y una edición mantiene su estado actual en vivo o borrador.

Si alguien editó el conector mientras la propuesta estaba pendiente, la tarjeta dice “Este cambio se basa en una versión desactualizada” y al aplicar pregunta “¿Aplicar sobre cambios más recientes?”. Las ediciones más recientes se sobrescriben solo si hace clic en Apply anyway.

Paso 6: Después de aplicar

Aparece un mensaje “Cambios aplicados con éxito” y el chat registra “Aplicó 1 cambio” con el conector marcado como Published o Draft. Cada cambio aplicado también aparece en el registro de actividad del equipo como “Propuesta de Operator aplicada”.

Un cambio publicado funciona como cualquier conector construido a mano, y Fin comienza a usarlo en conversaciones de inmediato. Un borrador no afecta las conversaciones hasta que se publique. Los clientes nunca ven a Operator ni sus propuestas.

Qué puede configurar Operator

Nombre y descripción — Los compañeros ven la descripción en la configuración del conector.
La solicitud — URL, método, encabezados y cuerpo. La URL debe ser HTTPS.
Entradas de datos — Los valores que Fin recopila del cliente, como un número de pedido. Cada entrada tiene un nombre, tipo y descripción, se marca como obligatoria u opcional y puede tener un valor predeterminado.
Tokens de autenticación — Operator puede adjuntar o separar tokens existentes. Cada token se envía como su propio encabezado.
Campos de respuesta — Construidos a partir de una respuesta de prueba o una respuesta simulada. Deciden qué campos ve Fin, cómo se llama cada uno, su formato y cómo se traducen los valores codificados en palabras. Un bloque de código Python puede remodelar la respuesta en su lugar.
Una respuesta simulada — Un cuerpo de respuesta de ejemplo, usado para construir los campos de respuesta antes de que se pueda probar la API.
Mapeos de objetos — Escriba valores de respuesta en atributos de conversación, usuario u objeto personalizado.
Cómo Fin lo usa — Si Fin puede elegir el conector por sí mismo, el prompt que Fin lee para decidir cuándo usarlo, si Fin puede escribir a través de él y una audiencia construida a partir de segmentos.
Verificación del cliente — Si Fin llama al conector solo para clientes que han pasado la verificación de identidad.

Consejo: Operator pone atributos del cliente, como el correo electrónico del cliente, directamente en la solicitud en lugar de agregarlos como entradas de datos. Esa es la configuración recomendada. Cada entrada de datos que Operator agrega es un valor que Fin recopila del cliente.

Limitaciones conocidas

Créditos de Operator — Los chats de Operator usan créditos de Operator como cualquier otro trabajo de Operator.
Usted aplica cada cambio — Operator no puede publicar, guardar ni eliminar un conector por sí mismo.
Las pruebas envían solicitudes reales — Si un conector crea, actualiza o elimina datos, probarlo realiza ese cambio en el sistema conectado. Use registros de prueba.
Tokens — Operator no puede ver los valores de los tokens de autenticación, ni puede crear, editar o eliminar tokens. Agregue un nuevo token en la configuración de Autenticación, luego pida a Operator que lo adjunte. Mantenga las claves API en tokens, no en la URL o el cuerpo, donde Operator puede leerlas.
Aplicar reemplaza las ediciones de borrador no publicadas — Operator construye su cambio sobre la versión en vivo. Aplicarlo, ya sea con Publish o Save as draft, reemplaza cualquier edición de borrador hecha en el editor desde entonces. Publique o descarte primero sus propias ediciones de borrador.
Los conectores en vivo no pueden eliminarse — Operator solo puede eliminar conectores en borrador o pausados. Para eliminar un conector en vivo, primero páuselo en su configuración. Operator no puede pausar, reanudar, duplicar o archivar conectores, ni volver a una versión anterior.
Conectores MCP — Operator no puede editar, probar ni eliminar conectores que provienen de un servidor MCP. Adminístrelos en la configuración del servidor MCP.
No hay plantillas — Operator no puede instalar un conector desde una plantilla.
Tipos de entrada — Operator no puede agregar valores de entrada estáticos, ni tipos de entrada de lista u objeto.
Versiones — Los cambios de conector de Operator se aplican directamente al conector. No pueden agregarse a una Fin Release.
Vista previa de Fin — Cuando Operator le hace a Fin una pregunta de prueba, Fin usa la respuesta de prueba guardada o simulada en lugar de llamar a la API. Las eliminaciones pendientes no se previsualizan, y un cambio sin respuesta de prueba o simulada no tiene nada que devolver.
Enlace de configuración — En la lista “You applied” del chat, el nombre del conector no enlaza a su página de configuración. Abra el conector desde la configuración de Data Connectors en su lugar.

Preguntas frecuentes

¿Por qué está deshabilitado el botón Publish?

No hay una prueba aprobada en la última versión del cambio. Cambiar la URL, método, encabezados, cuerpo, entradas o tokens de autenticación borra una prueba anterior. Pida a Operator que ejecute una prueba o use una respuesta simulada. Guardar como borrador siempre funciona.

¿Por qué una prueba falla con 401 cuando el conector funciona en conversaciones?

Las pruebas no llevan identidad de usuario final, por lo que los conectores que verifican quién es el cliente no pueden aprobar una prueba. Los tokens de tipo USER envían su valor de prueba estático en su lugar.

¿Qué puede ver Operator en mi conector?

Operator nunca ve los valores de los tokens de autenticación. Ve la URL, el cuerpo y el bloque de código completo, igual que la configuración de su conector le muestra, y solo los primeros cuatro caracteres de los valores de encabezado. En las respuestas de prueba, cualquier token o credencial que la API devuelva está enmascarado.

Construya y repare Data Connectors con Operator