Saltar al contenido principal

🧠 Personalización de Habilidades

Beak AI Studio le permite ampliar las capacidades de los agentes agregando habilidades personalizadas. Las habilidades pueden escribirse en Python, exponerse mediante APIs REST, definirse como instrucciones LLM o integrarse utilizando el Model Context Protocol (MCP).

Nota: Las habilidades personalizadas ahora se crean mediante un flujo de trabajo simplificado en dos pasos. Primero, defina la habilidad (tipo, nombre, descripción e instrucciones de uso). Luego, configure los detalles técnicos (código, especificación OpenAPI, instrucción, autenticación) durante la integración del agente. Consulte Habilidades Personalizadas para obtener una descripción completa.


Tipos de Habilidades​

  • Habilidades Prediseñadas: Proporcionadas por Beak AI para tareas comunes (búsqueda, resumen, etc.).
  • Habilidades Personalizadas: Cree su propia habilidad utilizando tipos predefinidos y regístrela en Studio.
  • Habilidades MCP: Utilice el Model Context Protocol para habilidades distribuidas e independientes del lenguaje.

Crear una Habilidad Personalizada​

  1. Cree la habilidad en Studio:

    • Elija "Generate and Execute Python Code" como tipo, proporcione un nombre, descripción e instrucciones de uso. (Las instrucciones determinan qué código debe generarse)
  2. Pruebe la habilidad en el área de pruebas de Studio.


Integrar Habilidades de API REST​

  1. Cree la habilidad en Studio:
    • Elija "REST API" como tipo, proporcione un nombre, descripción e instrucciones de uso.
  2. Configure durante la integración del agente:
    • Cargue o pegue la especificación OpenAPI de la API.
    • Proporcione los detalles de autenticación (claves de API, OAuth, etc.) según sea necesario.
  3. Pruebe la habilidad en el área de pruebas de Studio.

Crear una Habilidad de Instrucción LLM​

  1. Cree la habilidad en Studio:
    • Elija "LLM Prompt" como tipo, proporcione un nombre, descripción e instrucciones de uso.
  2. Configure durante la integración del agente:
    • Ingrese la plantilla de instrucción y seleccione el formato de análisis de respuesta (JSON o cadena de texto).
  3. **Pruebe la habilidad en el área de pruebas de Studio.

Ejemplo de instrucción para proporcionar durante la integración del agente:

Summarize the following customer feedback in one sentence: {text}

Usar Servidores MCP​

  • Implemente su habilidad como un servidor MCP (consulte la documentación de MCP).
  • Registre el servidor MCP en Studio y asigne sus herramientas como habilidades.
  • Benefíciese de la ejecución de habilidades distribuida e independiente del lenguaje.

Mejores Prácticas​

  • Utilice esquemas claros y con versiones para todas las entradas y salidas de habilidades.
  • Agregue docstrings y comentarios para facilitar el mantenimiento.
  • Pruebe las habilidades exhaustivamente en el área de pruebas de Studio antes de utilizarlas en producción.
  • Documente las dependencias y los pasos de integración.

Para una personalización más avanzada, consulte la Documentación de Habilidades de Studio y la Guía de Habilidades MCP.