Saltearse al contenido

Projects

Projects trabaja con los tableros de tareas de GitHub Projects. Lee los tableros de una organización o de un usuario y sus tareas, crea tareas nuevas, les cambia el estado (por ejemplo de Todo a In progress) o cualquier otro campo del tablero, y las archiva. Una tarea puede ser un borrador, con título y notas, o un issue o pull request que ya existe.

Cuándo usarlo

  • Un agente que, en una reunión o un chat, apunta las tareas acordadas en el tablero del proyecto.
  • Mover una tarea a Done cuando se despliega o cuando alguien lo pide.
  • Un informe de las tareas en curso, pendientes o de una persona.
  • Crear un tablero nuevo para un proyecto.

Configuración

Necesitas una credencial GitHub API. Los tableros de una organización necesitan un token con el permiso Projects de esa organización (lectura, o lectura y escritura para crear y modificar). Los tableros personales necesitan un token clásico con el permiso project, porque los tokens fine-grained no llegan a ellos. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial GitHub API.
Operation (obligatorio)List Projects, List Fields, List Items, Create Item, Update Item, Archive Item o Create Project.
Owner (obligatorio)La organización o el usuario dueño de los tableros, como en github.com/<owner>.
ProjectEl número del tablero (github.com/orgs/<owner>/projects/<número>) o su título exacto.
New project titleCreate Project: el título del tablero nuevo.
TaskUpdate Item y Archive Item: la tarea, por su ID (PVTI_…, de List Items) o por su título.
Title / NotesCreate Item: el título y la descripción de la tarea nueva. En Update Item, el nuevo título o las notas de un borrador.
Issue or pull requestCreate Item: el enlace de un issue o pull request que ya existe, para añadirlo al tablero en vez de crear un borrador.
Field valuesLos campos que se fijan, por nombre: Status=In progress; Priority=High; Due=2026-11-10. Las opciones tienen que existir en el tablero (las da List Fields).
FilterList Items: solo las tareas cuyo título o algún campo contiene este texto (un estado, una persona, una palabra).
LimitCuántos tableros o tareas devolver como máximo (por defecto, 100).

Resultado

  • List Projects: el número, el título, el enlace, si está cerrado y cuántas tareas tiene cada tablero.
  • List Fields: cada campo del tablero con su tipo y sus opciones (por ejemplo, las columnas de Status).
  • List Items: por tarea, su ID, si es borrador, issue o pull request, el título, el estado y el resto de campos, las personas asignadas, el enlace, el repositorio y las notas.
  • Create Item, Update Item, Archive Item y Create Project: la confirmación, con el ID de la tarea o el número del tablero y lo que se ha cambiado.

Si una opción no existe en el tablero, el error dice cuáles son las válidas. Una tarea archivada se puede recuperar desde el archivo del tablero en GitHub.

Como herramienta de un agente

Conéctalo al puerto de herramientas de un Agente o un Voice Agent con Owner y Project fijos. La IA rellena el título, las notas, la tarea y los campos. Conviene darle también List Fields para que sepa qué estados tiene el tablero. Ver Tool Mode.

Ejemplo

Un agente de voz que, en la reunión del proyecto, apunta las tareas:

  1. Añade Projects con Create Item, Owner mi-org y Project 3, conectado como herramienta del Voice Agent.
  2. Añade otro Projects con Update Item para que pueda moverlas de estado.
  3. En la reunión: «apunta que Pedro revise la PR 412, en curso»; el agente crea la tarea con Status=In progress.

Componentes relacionados