User manualManual de usuario › Agents, plans and schedules › Reviewing and stopping › PlansAgentes, planes y programaciones › Revisar y detener › Planes
Plans
Planes
When an agent wants to make several changes for one goal, it can bundle its proposals into a plan. You read the plan as a whole, approve the lines your role covers, and then run it.
Cuando un agente quiere hacer varios cambios por un mismo objetivo, puede juntar sus propuestas en un plan. Leés el plan entero, aprobás las líneas que cubre tu rol, y después lo ejecutás.
What a plan is
Qué es un plan
- A plan is made by an agent during a run, not by a person on screen. There is one plan per run.
- Each line is one proposal: an action, the agent that would execute it, and the decision its mandate took.
- Lines the mandate refused are left out. Only what can be done automatically or with confirmation enters the plan.
- Nothing in a plan is executed until someone runs it.
- Un plan lo arma un agente durante una corrida, no una persona en pantalla. Hay un plan por corrida.
- Cada línea es una propuesta: una acción, el agente que la ejecutaría, y la decisión que tomó su mandato.
- Las líneas que el mandato rechazó quedan afuera. Al plan entra solo lo que se puede hacer automáticamente o con confirmación.
- Nada de un plan se ejecuta hasta que alguien lo ejecuta.
The plans list
La lista de planes
Copilot → Plans lists the plans with Created, Plan (title and goal), Lines, Decisions (how many lines are automatic and how many need confirmation), Expires and Status. The only filter is Status. Click a row to open the plan.
Copilot → Planes lista los planes con Creado, Plan (título y objetivo), Líneas, Decisiones (cuántas líneas son automáticas y cuántas piden confirmación), Vence y Estado. El único filtro es Estado. Hacé clic en una fila para abrir el plan.
| Plan status | Meaning |
|---|---|
| Draft | Assembled by the agent, nobody has decided yet. |
| Proposed | Someone approved, but some lines still wait for a person with another role. |
| Approved | Every line is decided and at least one is approved. It can be executed. |
| Rejected | Rejected, or no line was left to run. |
| Executing | Its lines are being executed. |
| Executed | Every approved line ran. |
| Partially executed | Some lines ran and some failed. |
| Failed | Nothing ran and something broke. |
| Expired | Its time ran out before it was approved. |
| Estado del plan | Qué significa |
|---|---|
| Borrador | Armado por el agente, todavía nadie decidió. |
| Propuesto | Alguien aprobó, pero algunas líneas todavía esperan a una persona con otro rol. |
| Aprobado | Todas las líneas están decididas y al menos una está aprobada. Se puede ejecutar. |
| Rechazado | Rechazado, o no quedó ninguna línea para ejecutar. |
| Ejecutando | Sus líneas se están ejecutando. |
| Ejecutado | Todas las líneas aprobadas se ejecutaron. |
| Parcialmente ejecutado | Algunas líneas se ejecutaron y otras fallaron. |
| Falló | No se ejecutó nada y algo se rompió. |
| Vencido | Se le acabó el tiempo antes de ser aprobado. |
Read a plan
Leer un plan
The plan page shows when it was created, which run assembled it and when it expires. Decisions across the lines summarises them; Lines lists each one with its Action, Executing agent, Decision (Auto or Confirm, with the role that has to sign) and Status; Delegation lineage shows which agent asked which other for the work.
La página del plan muestra cuándo se creó, qué corrida lo armó y cuándo vence. Decisiones sobre las líneas las resume; Líneas lista cada una con su Acción, Agente que ejecuta, Decisión (Auto o Confirmar, con el rol que tiene que firmar) y Estado; Linaje de delegación muestra qué agente le pidió el trabajo a qué otro.
| Line status | Meaning |
|---|---|
| Pending | Waiting for someone with the right role. |
| Approved | Signed. It will run when the plan is executed. |
| Denied | Rejected. It will not run. |
| Executed | Done. |
| Failed | It was tried and the system refused it. The line shows the error. |
| Estado de la línea | Qué significa |
|---|---|
| Pendiente | Espera a alguien con el rol correcto. |
| Aprobada | Firmada. Se ejecuta cuando se ejecute el plan. |
| Denegada | Rechazada. No se ejecuta. |
| Ejecutada | Hecha. |
| Falló | Se intentó y el sistema la rechazó. La línea muestra el error. |
Approve, reject and execute
Aprobar, rechazar y ejecutar
- Read every line and check the records involved on their own screens.
- Press Approve and confirm. The automatic lines and the lines whose role you hold are signed. The others stay Pending, and a note tells you which lines still need a signature and from which roles.
- Wait for the other signatures if any are missing. The plan stays Proposed until every line is decided.
- Press Execute when the plan is Approved. Type the word the window asks for, and confirm.
- Read each line afterwards. The notice says "Execution finished — see each line for what it did."
- Leé cada línea y verificá los registros involucrados en sus propias pantallas.
- Tocá Aprobar y confirmá. Quedan firmadas las líneas automáticas y las líneas cuyo rol tenés. Las demás siguen Pendiente, y una nota te dice qué líneas todavía necesitan firma y de qué roles.
- Esperá las otras firmas si falta alguna. El plan queda Propuesto hasta que todas las líneas estén decididas.
- Tocá Ejecutar cuando el plan esté Aprobado. Escribí la palabra que pide la ventana y confirmá.
- Leé cada línea después. El aviso dice «La ejecución terminó: mirá cada línea para ver qué hizo.»
- Lines run one after another. If one fails, the others still run: the plan ends as Partially executed. What already ran is not undone.
- Reject denies every line that has not run and closes the plan. It is the only way to stop a plan.
- A plan expires twenty-four hours after its first proposal was made. Approve it before then.
- Approving and executing are separate. Approving changes nothing in your data; executing does.
- Las líneas se ejecutan una detrás de otra. Si una falla, las demás igual se ejecutan: el plan termina como Parcialmente ejecutado. Lo que ya se ejecutó no se deshace.
- Rechazar deniega todas las líneas que no se ejecutaron y cierra el plan. Es la única forma de frenar un plan.
- Un plan vence veinticuatro horas después de que se hizo su primera propuesta. Aprobalo antes.
- Aprobar y ejecutar son cosas separadas. Aprobar no cambia nada en tus datos; ejecutar sí.
⛔
Executing a plan makes every approved line for real, at once. There is no way to interrupt it half-way and no undo. Read the lines again before typing the confirmation word.Ejecutar un plan hace de verdad todas las líneas aprobadas, de una vez. No hay forma de interrumpirlo por la mitad ni de deshacerlo. Volvé a leer las líneas antes de escribir la palabra de confirmación.
Common issues
Problemas habituales
- "You are reading this plan. Approving, rejecting and executing need cop:plans:approve…"
- You can read plans but not decide them. Ask your administrator.
- "Line(s) … still need a signature from: …"
- Those lines need a role you do not hold. Someone with that role has to open the plan and press Approve.
- Execute is greyed out
- The plan is not Approved yet: some line is still Pending.
- "The plan could not be changed."
- The request failed or the plan changed in the meantime. Reload and read its status. If it expired, the agent has to assemble a new plan in another run.
- "No plans yet"
- No agent has assembled a plan. Plans appear only when an agent run bundles its proposals.
- The agent names show as short codes
- To see agent names and the delegation lineage you also need the permissions to view agents and to read runs.
- «Estás leyendo este plan…»
- Podés leer planes pero no decidirlos. Consultá a tu administrador.
- «La(s) línea(s) … todavía necesitan la firma de: …»
- Esas líneas requieren un rol que no tenés. Alguien con ese rol tiene que abrir el plan y tocar Aprobar.
- Ejecutar está en gris
- El plan todavía no está Aprobado: alguna línea sigue Pendiente.
- «No se pudo modificar el plan.»
- La solicitud falló o el plan cambió mientras tanto. Recargá y leé su estado. Si venció, el agente tiene que armar un plan nuevo en otra corrida.
- «Todavía no hay planes»
- Ningún agente armó un plan. Los planes aparecen solo cuando una corrida de agente junta sus propuestas.
- Los nombres de los agentes aparecen como códigos cortos
- Para ver los nombres de los agentes y el linaje de delegación también necesitás los permisos para ver agentes y para leer corridas.