Crear AI Skills

Mejore las automatizaciones con el poder de generative AI y cree AI Skills reutilizables en AI Agent Studio. Las AI Skills permiten a los pro developers configurar indicaciones, parámetros, entradas de archivos y conexiones de modelos para producir resultados de IA contextuales y consistentes que pueden reutilizarse en múltiples soluciones.

Las AI Skills se crean al seleccionar una Model connections, configurar la lógica de la indicación y poner la habilidad a disposición de los citizen developers y pro developers para la creación de automatizaciones

Nota: Antes de crear una AI Skills, confirme que la conexión de modelo que desea usar admite las funciones que requiere su caso de uso. Para ver una lista completa de los modelos compatibles, tipos de archivo y compatibilidad de funciones, consulte Habilidades de IA: modelos compatibles.

Este tema lo guiará a través de los pasos para crear una AI Skills.

Antes de empezar

Un desarrollador profesional requiere estos roles y permisos para crear y probar una AI Skill.
  • Rol: AAE_Basic, rol personalizado del desarrollador profesional
  • Permiso: Bot Creator
  • Configuración: Administración > Configuración > Administración de datos de IA > Configuración de registro de datos debe estar habilitado. El administrador de automatización puede habilitar esta configuración para el desarrollador profesional.

Consulte Roles y permisos

Otros requisitos:

Como parte de la prueba de Model connection, tendría que ejecutar el bot en su escritorio. Por lo tanto, asegúrese de que Bot Agent está configurado para su usuario. Si tiene que cambiar la conexión a otra Control Room, consulte: Cambiar el registro del dispositivo entre las instancias de Control Room.

Procedimiento

  1. Crear un nuevo AI Skill.
    1. Inicie sesión en el Control Room.
    2. Navegue a Automatización > Crear o haga clic en el ícono "+" y seleccione Habilidad de IA.
    3. Ingrese un nombre y una descripción y luego haga clic en Crear y editar. Creemos un ejemplo con el nombre Agente de alta de pacientes.
  2. Conexión de modelo: Elija una Model connection. En la parte superior del editor de AI Skill, haga clic en Elegir... debajo de Model connection para abrir la lista de Model connections asignadas a usted.
    Una vez seleccionada:

    • El nombre de la conexión del modelo, el proveedor y la descripción aparecen en el encabezado.

    • Los campos de parámetros, como Penalización de frecuencia, Penalización de presencia, N, Máximo de tokens, Temperatura y P superior, se vuelven editables.

    Estas configuraciones predeterminadas están adaptadas al modelo seleccionado, pero pueden ajustarse según sea necesario.

  3. Indicación del sistema (opcional): Utilice esto para definir el contexto general o las pautas de comportamiento. Si la Model connection seleccionada admite el System prompt, verá una sección del System prompt. Para obtener más información sobre System prompt, consulte Indicación del sistema. Por ejemplo:Es un médico de familia que está creando un plan integral de alta para el paciente.
  4. Indicador del usuario: Ingrese las instrucciones para el modelo. Hace referencia a las entradas de string con la sintaxis $variableNombre$. El mensaje del usuario admite la entrada de texto en varias líneas y el área de texto expandible como se muestra en la captura de pantalla. Por ejemplo: Crear un plan detallado de alta para el paciente... Utilizar los siguientes $detallespaciente$ para crear el encabezado…
  5. Entrada de indicación: (lado derecho)
    Entradas de string:
    • Haga clic en Agregar string o en + para agregar una string de entrada. Ingrese una Clave y un Valor.
    • Muestra las variables creadas para entradas basadas en texto.
    • Cada entrada incluye un nombre, valor y acciones (copiar, eliminar).
    • Ejemplo: detallespaciente.
    Entradas de archivo:
    • Haga clic en Agregar archivo o en + para agregar una string de archivo. Ingrese una Clave y un Valor.

    • Elija un archivo del repositorio de la Control Room o suba uno nuevo. Los tipos de archivos compatibles incluyen los siguientes:

      • Imágenes: .jpeg, .jpg, .png, .gif, .webp

      • Documentos: .txt, .pdf, .docx, .csv

    Parámetros de AI Skill
    Nota: Las restricciones específicas del modelo sobre el tamaño de archivo, los tipos compatibles y la cantidad máxima de archivos se aplican automáticamente.
  6. Indicación de archivos (opcional): La sección de solicitud de archivo se muestra solo cuando el modelo seleccionado admite entrada multimodal. Si ha agregado archivos, podrá seleccionar los archivos desde el menú desplegable. Controla qué entradas de archivo (del panel de archivos en el lado derecho) se incluyen en la solicitud final enviada al modelo.
    Nota: Los archivos adjuntos a una AI Skill no son procesados por AI Guardrails para el enmascaramiento de datos.

    Las barreras de seguridad evalúan y enmascaran únicamente los mensajes de texto.

    El contenido de los archivos se pasa directamente al modelo exactamente como se proporciona.

  7. Obtener respuesta: Use Obtener respuesta para previsualizar el resultado usando la Model connection seleccionada. Puede probar la AI Skill con las AI Guardrails. Utilice la opción Probar con barreras de seguridad de IA para simular el impacto de las barreras de seguridad seleccionadas en los indicadores y respuestas del modelo. Si se elige una barrera de seguridad, el indicador se escaneará en busca de toxicidad y datos sensibles. Si no se seleccionan barreras de seguridad, no se realizarán evaluaciones de barreras en los indicadores.
    Nota: Para usar Prueba con barreras de seguridad de IA, las AI Guardrails deben estar habilitadas en la configuración de administración global y necesitará los permisos de Ver barreras de seguridad de IA y Ver configuraciones. Puede revisar la pista de auditoría dentro de AI Governance para un registro detallado de cada prueba.

    Cuando esté probando con una barrera de seguridad, verá la Toxicidad tanto para el User prompt como para la Respuesta. Para ver los resultados del enmascaramiento de datos, haga clic en ver ejecución de enmascaramiento de datos. Mostrará los valores enmascarados tokenizados de cualquier dato sensible identificado en el indicador.

    Cuando una AI Skill envía un indicador que infringe una regla de bloqueo definida en una barrera de seguridad activa, la automatización que utiliza esa habilidad detendrá la ejecución con un mensaje de error y sin respuesta del LLM. El mensaje de error suele señalar que una barrera de seguridad bloqueó el indicador. Para obtener más información sobre la configuración de la regla de toxicidad, consulte Crear y gestionar AI Guardrails.

  8. Registro de datos: Aparece un interruptor en la parte superior derecha de la pantalla: Registro de datos deshabilitado.

    Cuando está habilitado: El interruptor cambia a Registro de datos activado. El sistema registra la indicación, la respuesta, los parámetros del modelo y los metadatos del archivo en IA > Administración > Registro de mensajes de IA

    Cuando está desactivado: Solo se registran metadatos mínimos.

    Los desarrolladores pueden decidir cuánta información se registra según la sensibilidad del contenido.

    Nota: AI Governance no almacena el contenido de los archivos cargados ni sus metadatos.

Ejemplo:

Haga clic en los tres puntos verticales junto a una AI Skill para ver y acceder a las acciones disponibles para el desarrollador profesional:

Acciones de AI Skill

Acciones Función
Mover AI Skill Haga clic en esta acción para seleccionar la ubicación a donde desea mover la AI Skill, según los permisos de su carpeta.
Registre la AI Skill Le permite registrar una AI Skill en una carpeta diferente. El Estado de la AI Skill se actualiza y se muestra en la carpeta que marcó en la AI Skill. Por ejemplo, si registró la AI Skill en la carpeta Público, la etiqueta Estado muestra Público.
Ver AI Skill Abre la AI Skill y muestra detalles.
Editar AI Skill Le permite editar la AI Skill.
Nota: El desarrollador profesional tiene este permiso.
Copiar AI Skill Le permite copiar una AI Skill existente para crear una nueva con los mismos detalles. Sin embargo, debe ponerle un nombre diferente, ya que no puede haber AI Skills duplicadas.
Nota: El desarrollador profesional tiene este permiso.
Ver referencias Le permite ver las referencias a otros bots que dependen directamente del actual donde se haya utilizado esta AI Skill.
Eliminar AI Skill Le permite eliminar una AI Skill.
Nota: El desarrollador profesional tiene este permiso.

Qué hacer a continuación

El siguiente paso sería registrar la AI Skills para ponerla a disposición de los Citizen Developers desde AI Skills de package.

¿Por qué podría desear registrar una AI Skill?

Después de crear una AI Skill, regístrela en la carpeta Pública. Esto permitirá que el desarrollador profesional y citizen developer la utilicen desde el AI Skills de package en el entorno de producción.

Como referencia, consulte:

Se puede agregar un Task Bot, con una o varias AI Skills integradas, a una automatización más grande que ejecutaría un escenario de flujo de trabajo completo.

Nota: Cuando crea o prueba una AI Skill en la pantalla Habilidades de IA, los detalles de éxito o falla junto con las respuestas del modelo se pueden ver en Administración > Registro de auditoría y en la navegación Administración > Gobernanza de IA. Consulte AI Governance

Como siguiente paso en la secuencia de tareas, vaya a Usar AI Skills en un Task Bot.