Saltar al contenido principal

Primeros pasos

Esta guía lleva a una organización del primer acceso a la primera ejecución.

1. Entrar al Agent Console​

Entra a https://app.kadu.ia.br con tu Cuenta Kobana. Si perteneces a más de una organización, elige cuál abrir; el cambio se hace después desde el menú del usuario, en Cambiar organización.

Pantalla de inicio de sesión de la consola

2. Conectar el Playbook​

Las tareas de Kadu viven en el Kadu Playbook de tu organización, un repositorio git. Mientras la organización no tenga uno, la consola muestra la tarjeta Conecta el Playbook:

  1. Haz clic en Instalar GitHub App y elige, en GitHub, el repositorio donde están las skills. La App solo pide lectura del contenido de los repositorios que elijas.
  2. GitHub vuelve a la consola, que confirma que la instalación es tuya y vincula el repositorio a la organización. Si la instalación da acceso a más de un repositorio, la consola te pide elegir cuál guarda el Playbook (los que tienen el catálogo del Playbook, .claude-plugin/marketplace.json, aparecen marcados).
  3. Kadu lee el repositorio y crea los workspaces, las actividades y las tareas declaradas en él. A partir de ahí, cada push en la rama predeterminada actualiza la consola automáticamente.

Si no tienes permiso para instalar la App en la cuenta de GitHub, la instalación se convierte en una solicitud al dueño de la cuenta. En cuanto la apruebe, el repositorio queda conectado.

¿Aún no tienes un Playbook? La sección Kadu Playbook explica cómo armar uno. Kobana también puede crear un Playbook inicial con una tarea de demostración para tu organización.

3. Verificar el plan​

Ejecutar una tarea exige tener Kadu en el plan de la organización con Kobana. Sin él, la consola muestra la barra Contratar el sistema y los botones de ejecutar quedan bloqueados. Todo lo demás (registro, lectura, configuraciones) sigue disponible. Ver Plan y costos.

4. Crear un entorno y registrar los secrets​

Cada ejecución corre en un entorno (por ejemplo, Producción y Sandbox), y es en el entorno donde se guardan los secrets: los tokens de los sistemas que usan las tareas.

  1. En Configuración → Entornos, crea el entorno (o revisa los que el repositorio ya declaró).
  2. En Configuración → Secrets, registra los valores. La pantalla marca como Pendiente todo secret que una tarea exige y que aún no tiene valor.

Ver Entornos y secrets.

5. Ejecutar la primera tarea​

Tareas de la actividad Contas a receber

  1. En la barra superior, elige el entorno, el workspace, la actividad y la tarea.
  2. Haz clic en Ejecutar ahora, revisa la fecha de referencia y los parámetros y confirma.
  3. Kadu empieza a trabajar en hasta 3 minutos. Sigue el historial, los logs y los pendientes en vivo en la pantalla de la ejecución.

Ver Ejecutar una tarea y Seguir una ejecución.

Próximos pasos​