Conectar guías a servicios externos con acciones de datos

Prerrequisitos 
  • Agente Virtual habilitado en su organización. Para obtener más información, póngase en contacto con su Customer Success Manager designado.
  • Permisos AI Studio para guías. Para obtener más información sobre todos los permisos necesarios, consulte AI Studio permissions. 

Las acciones de datos permiten a sus agentes de IA acceder a fuentes de datos externas y utilizar los datos recuperados para realizar la tarea en cuestión. Durante una conversación, su agente de IA puede recuperar información relevante sobre un contacto de una base de datos CRM, como el nombre, la dirección, los números de contacto, el número de cuenta o el estado de la cuenta.

Para obtener más información sobre la creación de una acción de datos personalizada, consulte Crear una acción personalizada para integraciones.

Utilizar acciones de datos

  1. Hacer clic Administración.
  2. En AI Studio, haga clic en Guías. 
  3. Haga clic en Menú > Orquestación > AI Studio > Guías.
  4. Abra una guía existente o cree una nueva.
  5. En la pestaña Instrucciones, coloque el cursor donde desee insertar una acción de datos y escriba /. 
    Aparecerá un cuadro de diálogo emergente con opciones para insertar una acción de datos o una variable.
  6. Seleccione Data Actions. El cuadro de diálogo enumera ahora las acciones de datos disponibles. 
  7. Seleccione la acción de datos deseada. 
  8. Para ver más detalles sobre la acción de datos, haga clic en el nombre de la acción de datos. 
    El panel derecho se expande y muestra información sobre la acción de datos. Haga clic en Ver y abra la acción de datos específica en una nueva pestaña del navegador o haga clic en Hecho para cerrar el panel y volver a la pestaña de instrucciones.
  9. Hacer clic Ahorrar.

Notas:
  • Asegúrese de que todos los parámetros de los contratos de entrada y salida de la acción de datos tienen descripciones adecuadas.
  • Asegúrese de que los nombres de los parámetros y las variables a las que corresponden coinciden correctamente.
  • El número máximo de acciones de datos que puede tener una guía es 20.
  • El número de invocaciones de acciones de datos en una guía cuenta para los límites de ejecución de acciones de datos por sesión.

Disponibilidad de las acciones de datos

  • Las acciones de datos seguros no están disponibles en las guías. 
  • Las acciones de datos pueden no estar disponibles para su selección en las guías si están configuradas de la siguiente manera:
    • Acciones de datos con parámetros de valor nulo
    • Acciones de datos con denominación incorrecta. El nombre de la acción de datos debe cumplir los siguientes requisitos:
      • Debe tener menos de 100 caracteres
      • Debe empezar por un carácter alfanumérico
      • Debe contener caracteres alfanuméricos, guiones bajos o guiones solamente
      • No debe contener guiones bajos ni guiones consecutivos
Nota: Si no ve una acción de datos en la lista de acciones de datos disponibles, pruebe a actualizar la página. La lista de acciones de datos disponibles se recupera al cargar la página.

Utilizar los parámetros de una acción de datos

Para utilizar los parámetros de una acción de datos, puede crear variables para las entradas y salidas. Deben coincidir en los nombres y tener descripciones significativas. Puede establecer el nombre y las descripciones al crear la acción de datos. Las descripciones de los parámetros deben proporcionar la información necesaria y ser similares a las descripciones de las variables que representan.

Ejemplos:

  • Eventos: Una lista de eventos que contiene el acto, el tipo y el lugar del evento
  • Número de pedido: Un número de 7 dígitos que representa el pedido del cliente

Para obtener más información sobre cómo escribir instrucciones y publicar una guía, consulte Escribir y publicar guías.