Desarrollar aApps

Si tienes previsto crear o personalizar aApps, sigue este enfoque:

1. Define primero las capacidades y después diseña la interfaz

   1. Empieza por definir el problema, los usuarios objetivo y el resultado esperado.

   2. Diseña las acciones semánticas (para que las invoque el Agent) antes de crear la interfaz.

   3. Evita crear demasiadas páginas y botones desde el principio, ya que aumenta la complejidad y reduce la capacidad de combinar componentes.

2. Crea interfaces compatibles con Agent

   1. Usa nombres claros y orientados a la acción.

   2. Mantén los parámetros concisos y coherentes.

   3. Diseña pensando en la capacidad de combinar componentes para poder encadenar de forma fiable los flujos de trabajo de varios pasos.

3. Crea primero un ciclo mínimo viable

   Da prioridad primero a este ciclo básico:

   Solicitud del usuario → El Agent llama a una aApp → La aApp devuelve un resultado útil

   Cuando este ciclo sea estable, amplíalo con capacidades avanzadas, como suscripciones, automatización y una interfaz más completa.

4. Separa la recuperación de información de la respuesta

   1. Usa capacidades orientadas a la recuperación cuando necesites candidatos estructurados (ID, metadatos y resultados procesables automáticamente).

   2. Usa capacidades orientadas a la respuesta cuando necesites respuestas directas para los usuarios.

   3. Esta separación mejora la fiabilidad, la interpretabilidad y el rendimiento.

5. Diseña la automatización de eventos como un proceso completo

   Una suscripción no es solo un activador. Un flujo sólido debe incluir:

   Condición de activación → Enriquecimiento del contexto → Análisis/procesamiento → Escritura de resultados/comentarios

   Así, la automatización aporta valor de forma constante en lugar de limitarse a «activar eventos».

Diseño de remio pensado para desarrolladores

1. Aislamiento de los entornos DEV / PROD

   1. DEV se utiliza para desarrollar, depurar y probar.

   2. PROD se utiliza para un uso diario estable.

   3. El código y los datos están aislados para que las pruebas no afecten al uso en producción.

2. Cambio visual de entorno

   1. El estado DEV/PROD aparece en la navegación y se puede cambiar fácilmente.

   2. Esto permite un desarrollo iterativo y seguro.

3. Dos puntos de entrada: Skill Market + Skill Studio

   1. Skill Market: descubre, instala y gestiona los Skills disponibles.

   2. Skill Studio: clona, modifica y publica Skills a modo de prueba.

   3. «Usar» y «crear» están claramente separados, lo que reduce el coste de adopción.

4. Integración con MCP: acceso sencillo + gran flexibilidad

   1. Admite una incorporación rápida mediante OAuth y la configuración manual (stdio / streamable-http).

   2. Se adapta tanto a una adopción rápida como a escenarios de integración avanzados.

Consejos para desarrolladores

• Valida todo minuciosamente en DEV antes de cambiar a PROD.

• Introduce una sola dependencia externa cada vez (por ejemplo, un servidor MCP) para facilitar la resolución de problemas.

• Reutiliza primero los Skills/aApps existentes y después personalízalos de forma gradual.

• En todos los flujos automatizados, añade una opción alternativa en caso de fallo y comentarios visibles para el usuario.