Saltar al contenido principal
Los conectores de datos permiten que los agentes de IA utilicen herramientas de servicios externos. Configura una conexión una sola vez y añade a las habilidades las herramientas específicas que necesita cada agente. Abre AI Agent > Data connectors para ver y gestionar tus conexiones.
Página Data connectors que muestra las pestañas Integrations, MCP y Custom API, además de las integraciones disponibles.

Open AI Agent > Data connectors to view Integrations, MCP servers, and Custom API connectors.

​
Elegir un tipo de conector

La página Data connectors ofrece tres formas de conectar un servicio externo: Selecciona la pestaña correspondiente para buscar conexiones existentes o configurar una nueva.

​
Añadir herramientas de conectores a una habilidad del agente de IA

Conectar un servicio no añade automáticamente todas las herramientas disponibles a todos los agentes de IA. Elige en sus habilidades las herramientas que puede utilizar cada agente.
  1. Abre el agente de IA que deseas configurar.
  2. En Profile, busca Skills y selecciona Manage.
  3. Crea una habilidad o abre una existente.
  4. En Step-by-Step instructions, escribe /.
  5. Expande el grupo Integration, MCP o Data connectors correspondiente y selecciona la herramienta que deseas insertar.
  6. Explica cuándo debe utilizarse la herramienta, qué información debe recopilarse y qué hacer con el resultado.
  7. Guarda la habilidad, pruébala en Preview y publica el agente de IA cuando esté listo.
Editor de habilidades del agente de IA que muestra el menú de comandos con las herramientas de Shopify Admin.

Type / in Step-by-Step instructions, then select a tool from the connected Shopify Admin integration.

Define para cada paso del conector una ruta clara para los resultados correctos, los resultados vacíos y los errores. No pidas al agente de IA que deduzca información que la herramienta no devuelve.
Para obtener más orientación sobre activadores, instrucciones y pruebas, consulta Habilidades de IA.

​
Ejemplo: Consultar un pedido de Shopify

Este ejemplo crea una habilidad que puede responder preguntas sobre el pedido y el envío de un cliente en Shopify.

​
1. Conectar Shopify Admin

  1. Ve a AI Agent > Data connectors.
  2. En la pestaña Integrations, abre Shopify Admin y completa el proceso de autorización.
  3. Confirma que la integración muestre Connected.
Shopify Admin proporciona herramientas de solo lectura como las siguientes:
  • find_orders para encontrar un pedido a partir de la información proporcionada por el cliente
  • get_order para obtener el pedido seleccionado
  • get_order_fulfillments para obtener los detalles del envío y la preparación del pedido
  • get_fulfillment_events para obtener los eventos de seguimiento del envío
  • get_order_returns y get_return para obtener los detalles de una devolución
  • get_order_refunds y get_refund para obtener los detalles de un reembolso

​
2. Crear la habilidad

En Profile del agente de IA, selecciona Manage en Skills y crea una habilidad con la siguiente configuración. Name
Consultar un pedido de Shopify
Start trigger
Utiliza esta habilidad cuando un cliente pregunte por el estado de un pedido, envío, devolución o reembolso de Shopify. No la utilices para recomendaciones de productos, preguntas sobre el pago ni solicitudes de modificación de un pedido.
Step-by-Step instructions
  1. Pide al cliente la información necesaria para identificar el pedido.
  2. Escribe / e inserta find_orders desde Integration · Shopify Admin. Utilízala para encontrar el pedido correspondiente.
  3. Si no coincide ningún pedido o coincide más de uno, solicita al cliente información adicional para identificarlo. No adivines a qué pedido se refiere.
  4. Inserta y utiliza get_order para el pedido correspondiente.
  5. Si el cliente pregunta por el envío, inserta y utiliza get_order_fulfillments. Utiliza get_fulfillment_events cuando necesites los eventos de seguimiento.
  6. Si el cliente pregunta por una devolución o un reembolso, inserta la herramienta correspondiente.
  7. Resume únicamente la información que devuelvan las herramientas. Si una herramienta falla o la información solicitada no está disponible, explica que no puedes confirmar el resultado y transfiere la conversación cuando corresponda.
Los nombres de las herramientas anteriores aparecen en el menú de comandos / después de conectar Shopify Admin. Selecciona los comandos en ese menú en lugar de escribir sus nombres como texto sin formato.

​
3. Probar antes de publicar

Prueba al menos los siguientes casos en Preview:
  • Un pedido coincide con la información del cliente
  • No coincide ningún pedido
  • Coinciden varios pedidos
  • Los detalles de preparación o seguimiento no están disponibles
  • La herramienta de Shopify devuelve un error
  • El cliente pide al agente que modifique un pedido, algo que la integración de solo lectura Shopify Admin no puede hacer

​
Crear un conector Custom API

Utiliza un conector Custom API cuando quieras que una habilidad del agente de IA llame a tu propia API HTTPS. En la pestaña Custom API, selecciona New data connector. También puedes buscar conectores Custom API existentes por nombre y filtrarlos por estado.
Página completa Data connectors con búsqueda, filtros de estado, conectores existentes y New data connector.

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

​
Nombre y descripción

Asigna al conector un nombre que describa su función, como retrieve_order. En la descripción, explica cuándo debe utilizarse y qué devuelve.
Paso About 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.

​
Configurar la solicitud API

Introduce el endpoint HTTPS y selecciona el método de solicitud:
  • GET lee información.
  • POST crea información.
  • PUT sustituye o actualiza información.
  • PATCH actualiza parte de un recurso.
  • DELETE elimina información.
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

Selecciona Add header e introduce cada encabezado obligatorio como un par clave-valor.
Formulario completo de conexión API que muestra los encabezados 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

Para las solicitudes que envían datos, introduce un cuerpo JSON válido con los campos que requiere tu API.
Página del conector de datos desplazada hasta el cuerpo JSON de una solicitud POST.

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

​
Probar la respuesta

Selecciona Test request para verificar que el conector devuelve la respuesta esperada.
La prueba envía una solicitud API real. Una solicitud POST, PUT, PATCH o DELETE puede crear, modificar o eliminar datos. Siempre que sea posible, realiza la prueba en un entorno seguro o comienza con una solicitud GET de solo lectura.
Paso Test response con Test Request y el botón Set live desactivado.

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

​
Activar el conector

Después de una prueba correcta, selecciona Set live. Los conectores Custom API activos pueden seleccionarse desde el menú de comandos / de las instrucciones de la habilidad. Para dejar de utilizar un conector Custom API, ábrelo y selecciona Set to draft, o desactiva su estado en la lista de conectores. Revisa y resuelve todas las dependencias indicadas antes de pasarlo a borrador.
Lista completa de Data connectors con los interruptores Status de 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.