Skip to main content

​
¿Qué son los conectores de datos?

Los conectores de datos son integraciones profundamente integradas que pueden conectar tus datos externos en tiempo real con nosotros. Una excelente manera de comenzar es pensar en aquellas preguntas comunes a las que tus compañeros de equipo dedican un tiempo considerable respondiendo, utilizando información que actualmente no está disponible en nuestra plataforma. Estas pueden ser preguntas en las que tus clientes simplemente quieren obtener información que almacenas en un sistema externo, como «¿Se ha entregado mi pedido?», o actualizar información en tu sistema externo, como «Reprogramar una entrega» o «Procesar un reembolso».

​
Creación de un conector de datos

Primero, ve a Agente de IA > Conectores de datos. Aquí es donde puedes configurar conectores de datos para conectar tus datos externos. Puedes crear uno haciendo clic en Nuevo conector de datos. También puedes buscar conectores de datos específicos por su nombre y estado.
Página completa de Conectores de datos con búsqueda, filtros de estado, conectores existentes y Nuevo conector de datos.

Open AI Agent > Data connectors, then select New data connector.

​
Nombre y descripción

Asigna a tu conector de datos un nombre que indique claramente su función específica (p. ej., «retrieve_order_id»). En el campo de descripción, informa a tus compañeros de equipo sobre cuándo utilizar este conector y qué datos recuperará (p. ej., «Obtiene los detalles del pedido para un ID de pedido proporcionado»).
Paso Acerca del conector de datos con los campos de nombre y descripción resaltados.

Describe the connector’s purpose in About before configuring its API request. This draft has not been saved.

​
Conexión API

​
Solicitud API

A continuación, completa los detalles de la solicitud. Aquí es donde deberás introducir la URL HTTPS del sistema de terceros al que te estás conectando. Puedes especificar qué conector de datos deseas que utilice esta solicitud seleccionando el método:
  • GET - Lee y almacena información del sistema de terceros.
  • POST - Crea o añade información al sistema de terceros.
  • PUT - Actualiza información en el sistema de terceros.
  • DELETE - Elimina información del sistema de terceros.
  • PATCH - Actualiza información en el sistema de terceros.
Paso de conexión API del conector de datos con el método HTTP y la URL resaltados.

Choose the HTTP method and enter the endpoint URL. This incomplete draft has not sent a request.

​
Encabezados HTTP

Puedes optar por añadir parámetros adicionales a esta solicitud haciendo clic en Añadir encabezado y luego añadir el Par clave-valor en Encabezados HTTP:
Formulario completo de conexión API que muestra los encabezados de solicitud Content-Type y Accept.

Select Add header and enter each header as a key-value pair. This example has not been saved or sent.

​
Cuerpo de la solicitud

Si realizas una solicitud POST o PUT, tendrás la opción de proporcionar un cuerpo de solicitud para incluir los datos que desees enviar en la solicitud:
Página completa del conector de datos desplazada hasta el cuerpo de la solicitud JSON POST.

Enter valid JSON in Request Body. This fictional order example has not been sent.

​
Probar respuesta

A continuación, deberás probar la respuesta de este conector de datos para asegurarte de que obtiene los datos correctos del sistema externo al que te estás conectando.
Importante: Probar esta solicitud establece una conexión con la API, por lo que completará el conector de datos que has creado. Por ejemplo, si le has pedido que realice un DELETE de datos desde la API, esta información se eliminará. Intenta probar con una solicitud GET para asegurarte de que solo estás leyendo información y no modificándola.
Haz clic en Probar solicitud para comprobar que el conector de datos se ha configurado correctamente.
Paso de prueba de respuesta con Probar solicitud y un botón Publicar deshabilitado.

Select Test Request to run the configured API call. No request has been run in this example.

​
Publicar

Una vez que hayas probado el conector de datos con éxito, estará listo para publicarse. Selecciona Publicar en la parte superior derecha después de que la prueba sea exitosa. En el ejemplo anterior no probado, este botón se mantiene deshabilitado.

​
Cambiar a borrador

Si deseas descontinuar conectores de datos antiguos que ya no sean necesarios, puedes cambiarlos al estado de borrador. Puedes hacer clic en el conector de datos que deseas pasar a borrador y luego seleccionar Cambiar a borrador, o bien desactivar el interruptor de estado en la lista.
Lista completa de Conectores de datos con los interruptores de estado para los conectores activos existentes.

Use the Status switch in the list to move a live connector to draft. The switches shown here have not been changed.

Esto comprobará si existen dependencias en este conector de datos. Deberás revisar y resolver estas dependencias antes de pasarlo al estado de borrador.