Saltar al contenido principal
Los conectores de datos permiten que los Agentes de IA accedan a herramientas de servicios externos. Configura una conexión una vez y luego añade a sus Habilidades las herramientas específicas que necesita un Agente. Abre AI Agent > Data connectors para ver y gestionar tus conexiones.
Página de conectores de datos que muestra las pestañas Integraciones, MCP y Custom API, junto con las integraciones disponibles.

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

Elige un tipo de conector

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

Añade herramientas de conector a una Habilidad del Agente de IA

Conectar un servicio no añade automáticamente todas las herramientas disponibles a cada Agente de IA. Elige las herramientas que cada Agente puede utilizar en sus Habilidades.
  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. Despliega el grupo relevante de Integration, MCP o Data connectors , y luego selecciona la herramienta que quieras insertar.
  6. Explica cuándo usar la herramienta, qué información recopilar y qué hacer con su resultado.
  7. Guarda la Habilidad, pruébala en Vista previa y publica el Agente de IA cuando esté listo.
Editor de Habilidades del Agente de IA que muestra el menú de comandos de barra diagonal con herramientas de Shopify Admin.

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

Asigna a cada paso del conector una ruta de éxito clara, una ruta para resultados vacíos y una ruta de fallo. No pidas al Agente de IA que deduzca información que la herramienta no devuelve.
Para más orientación sobre activadores, instrucciones y pruebas, consulta AI Skills.

Ejemplo: Consultar un pedido de Shopify

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

1. Conecta Shopify Admin

  1. Ve a AI Agent > Data connectors.
  2. En la pestaña Integrations , abre Shopify Admin y completa el flujo de autorización.
  3. Confirma que la integración muestre Connected.
Shopify Admin ofrece herramientas de solo lectura como:
  • find_orders para encontrar un pedido a partir de la información proporcionada por el cliente
  • get_order para recuperar el pedido seleccionado
  • get_order_fulfillments para recuperar detalles de envío y procesamiento
  • get_fulfillment_events para recuperar eventos de seguimiento de envíos
  • get_order_returns y get_return para recuperar detalles de devoluciones
  • get_order_refunds y get_refund para recuperar detalles de reembolsos

2. Crea la Habilidad

En Profile del Agente de IA, selecciona Manage debajo de Skills, luego crea una Habilidad con la siguiente configuración. Name
Consultar un pedido de Shopify
Start trigger
Usa 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 proceso de pago o solicitudes para modificar 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. Úsalo para encontrar el pedido correspondiente.
  3. Si ningún pedido coincide o si coincide más de uno, pide al cliente información de identificación adicional. No intentes adivinar a qué pedido se refiere.
  4. Inserta y usa get_order para el pedido que coincida.
  5. Si el cliente pregunta por el envío, inserta y usa get_order_fulfillments. Usa get_fulfillment_events cuando se necesiten detalles de eventos de seguimiento.
  6. Si el cliente pregunta por una devolución o reembolso, inserta la herramienta de devolución o reembolso correspondiente.
  7. Resume únicamente la información devuelta por 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 herramientas anteriores aparecen en el menú de comandos / después de conectar Shopify Admin. Selecciona los comandos desde ese menú en lugar de introducir sus nombres como texto sin formato.

3. Realiza pruebas antes de publicar

En Vista previa, prueba al menos estos casos:
  • Un pedido coincide con la información del cliente
  • Ningún pedido coincide
  • Varios pedidos coinciden
  • Los detalles de procesamiento o seguimiento no están disponibles
  • La herramienta de Shopify devuelve un error
  • El cliente le pide al agente que modifique un pedido, algo que la integración de solo lectura de Shopify Admin no puede hacer

Crear un conector de API personalizada

Usa un conector de API personalizada 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 de API personalizada existentes por nombre y filtrarlos por estado.
Página completa de conectores de datos 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 usarse el conector y qué devuelve.
Paso About del conector de datos con los campos de nombre y descripción destacados.

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

Configurar la solicitud de API

Introduce el endpoint HTTPS y selecciona el método de solicitud:
  • GET lee información.
  • POST crea información.
  • PUT reemplaza o actualiza información.
  • PATCH actualiza parte de un recurso.
  • DELETE elimina información.
Paso de conexión de la API del conector de datos con el método HTTP y la URL destacados.

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

Encabezados HTTP

Selecciona Add header y, a continuación, introduce cada encabezado requerido como un par clave-valor.
Formulario completo de conexión de la 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

Para las solicitudes que envían datos, introduce un cuerpo de solicitud JSON válido que contenga los campos requeridos por tu API.
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 la respuesta

Selecciona Test request para verificar que el conector devuelva la respuesta esperada.
La prueba envía una solicitud de 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.

Publicar el conector

Tras una prueba correcta, selecciona Set live. Los conectores de API personalizada activos se pueden seleccionar desde el menú de comandos / en las instrucciones de la habilidad. Para dejar de usar un conector de API personalizada, ábrelo y selecciona Set to draft, o desactiva su estado desde la lista de conectores. Revisa y resuelve cualquier dependencia indicada antes de pasarlo a borrador.
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.