> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectores de datos

> Conecta servicios externos mediante Integrations, MCP o Custom API y utiliza sus herramientas en las habilidades del agente de IA.

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.](https://mintcdn.com/lchnan/RNoD5r5OXiTray6k/product-assets/english-help-2026-10-30/data-connectors-integrations.png?fit=max\&auto=format\&n=RNoD5r5OXiTray6k\&q=85\&s=f70d467e86e5027f147b3b063f161a36)

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:

| Tipo | Úsalo para |
| - | - |
| **Integrations** | Conectar un servicio compatible mediante un proceso de autorización guiado. Por ejemplo, Shopify Admin proporciona herramientas de solo lectura para pedidos, seguimiento de envíos, devoluciones y reembolsos. |
| **MCP** | Conectar un servidor MCP y poner las herramientas que expone a disposición de tus agentes de IA. |
| **Custom API** | Crear una solicitud HTTP personalizada a un endpoint HTTPS cuando necesites conectar tu propia API. |

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.](https://mintcdn.com/lchnan/RNoD5r5OXiTray6k/product-assets/english-help-2026-10-30/shopify-skill-command-menu.png?fit=max\&auto=format\&n=RNoD5r5OXiTray6k\&q=85\&s=beb0f5f6d2938e563088e177eca982c4)

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

> [!TIP]
>
> 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](https://docs.ycloud.com/es/documentation/agents/ai-agent/ai-skills.md).

## 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.

> [!NOTE]
>
> 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.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-list-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=1e69a488687c963b905ed5916ebd9b9c)

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.](https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/connector-about-annotated.svg?fit=max\&auto=format\&n=gXEJIQXV2JH2VUQJ\&q=85\&s=a57c6777577f87f55494f26d51d28eb2)

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.](https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/connector-api-annotated.svg?fit=max\&auto=format\&n=gXEJIQXV2JH2VUQJ\&q=85\&s=5effb08c414cdb9ecc3bce86ed58e377)

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.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-headers-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=f23c6cb0a8f850aa38a904ed0d1900cf)

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.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-body-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=5099ae99db2d135e6253c53ecefb9937)

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.

> [!WARNING]
>
> **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.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-test-entry-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=087754abdc3b082833f41e0822a3261c)

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.](https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-status-annotated.svg?fit=max\&auto=format\&n=6u8ntRayC38GXyQF\&q=85\&s=36fb2456c31e1e068179cc06e978feed)

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.