Saltar al contenido principal

Creación de Habilidades

Las habilidades son las acciones reutilizables que un agente puede invocar. La lista de Habilidades muestra todas las habilidades del espacio de trabajo con su Skill Type, Category, estado y hora de última actualización. Los filtros permiten acotar por estado, categoría y tipo. El botón Create Skill en la parte superior derecha abre el constructor.

Información Básica​

Toda habilidad comienza con los mismos metadatos:

  • Name — El identificador que ve el LLM (p. ej. Check Disk Usage).
  • Category — Agrupación de forma libre que se muestra en listas y filtros.
  • Description — Se convierte en la descripción de herramienta visible para el LLM. La descripción es la forma en que el modelo decide si invocar la habilidad, por lo que debe redactarse como una instrucción clara, no como texto de marketing.

Tipo de Habilidad​

Seleccione uno de los cinco modos de ejecución. Cada tipo muestra una sección Configuration diferente a continuación.

Ejecución de Tarea Basada en Prompts​

Ejecuta una plantilla de prompt contra el LLM del espacio de trabajo y devuelve el resultado. Ideal para tareas de clasificación, extracción, resumen y generación que no requieren herramientas externas.

  • Prompt — Editor de markdown en línea o una referencia a la biblioteca de Prompts. Admite interpolación {{ variable }} desde las entradas.
  • Output Parser — Text (predeterminado) devuelve la respuesta sin procesar; JSON analiza la respuesta como JSON antes de devolverla al agente.

Integración con API Externa​

Llama a cualquier endpoint REST descrito por una especificación OpenAPI 3.0. El Studio utiliza la especificación para construir el esquema de herramienta y enrutar las llamadas.

  • OpenAPI Specification (JSON) — Pegue la especificación o cárguela. Las entradas se extraen automáticamente de los parámetros y el cuerpo de la solicitud de la especificación.
  • Additional Context — Notas de forma libre inyectadas junto con la descripción de la herramienta.
  • Requires Authentication — Active esta opción para requerir una credencial cuando la habilidad se adjunta a un agente. La credencial se selecciona en el momento de vincular el agente, no al crear la habilidad, por lo que la misma habilidad puede reutilizarse en distintos inquilinos y entornos.

Ejecución de Consulta KQL​

Ejecuta una instrucción de Kusto Query Language contra una fuente de datos con un esquema de tabla y un rango de tiempo definidos.

  • Table Schema (JSON) — Define el nombre de la tabla, las columnas y los tipos para que el LLM pueda crear KQL válido.
  • Inputs — Rango de tiempo y cualquier parámetro adicional que el LLM deba extraer.

Ejecución de Código​

Ejecuta un script de Python o PowerShell en un entorno de espacio aislado.

  • Language — Python o PowerShell.
  • Code Input Method — Generate code permite que el LLM escriba el script a partir de su Instruction; Provide code ejecuta un script estático que usted pega. Esta última opción expone un campo Variables para pares key=value inyectados como entradas.
  • Additional Context — Restricciones o bibliotecas que el LLM debe respetar.

Activar Sub-Agente​

Delega la solicitud a otro agente publicado y devuelve su respuesta — una forma ligera de componer agentes sin necesidad de construir un orquestador completo.

  • Target agent — El agente publicado que esta habilidad invoca. El sub-agente se ejecuta con su propio modelo, habilidades y fuentes de datos, y devuelve su respuesta al agente que lo llamó.

Entradas​

Las entradas son los parámetros que el LLM extrae del mensaje del usuario en tiempo de ejecución. Cada tipo de habilidad tiene una sección Inputs con un botón Add Input. Cada entrada tiene un nombre, tipo, descripción e indicador de obligatoriedad. En el caso de Ejecución de Código, las entradas también se exponen como variables de entorno en el espacio aislado.

Nota: Si una habilidad no tiene entradas definidas, el LLM sigue pasando el contexto de la conversación (cuando Include Conversation Context está activado) — pero para cualquier elemento con estado, es preferible usar entradas explícitas en lugar de depender del análisis de la conversación.

Configuración​

  • Audit — Registra cada ejecución de habilidad en el registro de auditoría. Obligatorio para habilidades con efectos secundarios.
  • Approval — Requiere aprobación humana antes de que se ejecute la habilidad. La llamada planificada queda en espera y se enruta a un aprobador, quien ve los argumentos exactos de la herramienta antes de decidir. Consulte Elegir quién aprueba a continuación.
  • Include Conversation Context — Pasa el historial reciente de la conversación a la habilidad junto con las entradas explícitas. Activado de forma predeterminada.

Elegir quién aprueba​

Activar Approval determina que una llamada se pause. Quién la aprueba lo decide una política de aprobación en el inquilino, no en la habilidad — de modo que una regla como "todo lo que implique gasto económico requiere la autorización de finanzas" se establece una sola vez y se aplica en todas partes, en lugar de repetirse en cada habilidad de cada agente.

El orden de precedencia para una sola llamada bloqueada es:

  1. La anulación de aprobación de la habilidad en el agente, si se ha configurado una — véase a continuación.
  2. La política de aprobación coincidente de mayor prioridad para el inquilino.
  3. El aprobador de reserva del inquilino.
  4. Rechazo. Una llamada que requiere aprobación y no resuelve a nadie no se ejecuta, y se le indica al agente el motivo.

Este último paso es deliberado: una aprobación que nadie puede gestionar no es una aprobación, por lo que la plataforma rechaza en lugar de proceder.

Etiquetas de capacidad​

Una política generalmente coincide en lo que una habilidad hace en lugar de nombrarla. Etiquete la habilidad con cualquiera de sends_communication, writes_external, spends_money, deletes_data, touches_pii, grants_access, executes_code, modifies_config, y una política escrita contra esa etiqueta la cubre automáticamente — incluidas las habilidades añadidas posteriormente.

Anulación para una habilidad específica​

El control por habilidad se encuentra en la sección Workflow de la configuración de la habilidad en el agente, y es deliberadamente secundario a la política:

  • Follow policy — Valor predeterminado. Las políticas del inquilino deciden.
  • Always require — Esta habilidad siempre se pausa, independientemente de lo que digan las políticas.
  • Never require — Esta habilidad nunca se pausa.

Una anulación también puede nombrar a su propio aprobador, que tiene precedencia sobre la política coincidente solo para esa habilidad.

Nota: Cada solicitud de aprobación registra qué política la coincidió y por qué. Ese razonamiento se muestra al aprobador en la solicitud, de modo que ninguna decisión se toma a ciegas.

Aprobaciones en ejecuciones programadas y por webhook​

Una ejecución de agente iniciada por una programación o un webhook no tiene a nadie esperando en el chat. Cuando dicha ejecución llega a una habilidad bloqueada por aprobación, la ejecución se detiene y se marca como failed, y la solicitud de aprobación permanece pendiente en la bandeja de entrada de Approvals para que un aprobador la gestione. La habilidad no se ejecuta hasta que se aprueba y el agente se vuelve a ejecutar.

Dado que estas ejecuciones no están supervisadas, una política puede apuntarlas específicamente — exigiendo aprobación para una acción cuando se ejecuta según una programación, mientras que la permite en un chat interactivo.

Nota: Asegúrese de que una política o el aprobador de reserva del inquilino nombre a un aprobador para cualquier habilidad que utilice un agente programado. Si no hay nadie a quien consultar, la llamada se rechaza en lugar de quedar en espera.

Mensaje de Acción​

Una cadena de estado breve que se muestra al usuario en el chat mientras se ejecuta la habilidad (p. ej. Running disk-usage check…). Opcional, pero recomendado para cualquier habilidad que tarde más de un segundo.

Ciclo de Vida​

La barra de herramientas del editor de Habilidades es igual a la del editor de Agentes: Save, alternador Published, Discard y una vista de Historial. Solo las habilidades publicadas aparecen en el selector de Habilidades del constructor de agentes. Consulte Gestión del Ciclo de Vida de Habilidades.

Páginas Relacionadas​