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. Abra una guía existente o cree una nueva.
  4. 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.
  5. Seleccione Data Actions. El cuadro de diálogo enumera ahora las acciones de datos disponibles. 
  6. Seleccione la acción de datos deseada. El editor resalta las variables presentes en su guía mediante un subrayado azul.
  7. 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 para abrir 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.
  8. Hacer clic Ahorrar.

Notas:
  • El número máximo de acciones de datos que puede tener en una guía es cinco.
  • El número máximo de parámetros de entrada de una acción de datos que puede utilizar en una guía es cuatro.
  • 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 más de cuatro parámetros de entrada
    • 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 un parámetro de entrada o salida de una acción de datos en sus guías, especifique el nombre exacto del parámetro, por ejemplo, Save OrderStatus. Evite crear variables para parámetros de acciones de datos a menos que desee enviar o recibir esos datos de Architect. 

Si debe crear una variable para un parámetro de acción de datos, añada un paso en sus guías para ayudar al sistema a asignar la salida de la acción de datos a la variable de la guía. Por ejemplo, Save OrderStatus as CustomerOrderStatus.

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