---
title: Agentes
description: >-
  Para qué sirven los agentes, cómo funciona una ejecución, y las dos formas de
  obtener uno, agregándolo desde el catálogo o creando el tuyo propio.
sidebar:
  label: Resumen
  icon: layers
---
Un agente es un pequeño trabajador que vive dentro de tu espacio de trabajo. Se activa cuando tú se lo indicas, lee lo que necesita entre clientes, proyectos, tareas y documentos, hace un trabajo y reporta de vuelta. Nadie tiene que pedírselo. Ese es todo el punto.

MCP es cuando tú extraes contexto de Ali cuando lo quieres. Los agentes son Ali empujando la respuesta hacia ti antes de que preguntes.

Todo sucede en la pantalla de **Agentes** en la barra lateral.

![La pantalla de Agentes, con agentes instalados en la organización y el catálogo debajo](/images/agents/overview.webp)

La pantalla tiene dos listas. **En esta organización** es lo que ya está funcionando para tu espacio de trabajo. **Disponibles para agregar** es el catálogo: agentes listos para usar que puedes instalar con un clic.

## En qué son buenos los agentes

El patrón que funciona es acotado y repetitivo. Un trabajo, un horario, un lugar donde reportar:

- Un resumen matutino de todo lo que vence hoy, agrupado por proyecto.
- Un barrido de fin de día de tareas atrasadas, nombrando quién tiene cada una a su cargo.
- Una reacción cuando una tarea pasa a Bloqueada, resumiendo por qué está atascada.
- Un resumen de los viernes de cada cuenta y su trabajo pendiente, enviado al canal del equipo.

El patrón que no funciona es "mantener un ojo sobre las cosas". Un agente con una instrucción vaga produce un reporte vago, y un reporte vago se ignora después de una semana.

## Cómo funciona una ejecución

Cada agente, ya sea que lo hayas instalado o creado, se compone de las mismas cuatro partes.

1. **Se activa un disparador**

    Ya sea un horario que tú definas, como de lunes a viernes a las 08:00 en tu zona horaria, o un evento en el espacio de trabajo, como una tarea que cambia de estado.

2. **El agente lee tu espacio de trabajo**

    Lee según los permisos que le otorgaste, y nada más. Un agente con acceso de lectura a Tareas y Proyectos no puede abrir un registro de cliente.

3. **Sigue su instrucción**

    La instrucción es lenguaje sencillo que tú escribiste. Es lo más parecido que tiene el agente a una descripción de trabajo, así que vale la pena escribirla con cuidado.

4. **Reporta de vuelta**

    Hacia la bandeja de entrada del espacio de trabajo, un canal de Slack o Discord, o un correo a las personas que elijas.

Cada ejecución queda registrada, con su estado, cuánto tardó, cuánto costó y qué produjo. Puedes leer todo el historial en cualquier momento, y puedes activar una ejecución manualmente sin esperar al horario.

## Quién puede administrarlos

Los propietarios y administradores pueden crear, configurar, activar, desactivar y eliminar agentes. Todos los demás ven la misma lista y pueden abrir un agente para leer sus detalles, pero los interruptores y el botón de guardar no están disponibles para ellos. Eso mantiene el conjunto de agentes en ejecución como algo que decide el espacio de trabajo, no algo que crece silenciosamente.

## Dos formas de obtener un agente

<CardGroup cols={2}>
  <Card title="Agrega uno del catálogo" href="/agents/catalogue" icon="package">
    Elige un agente listo para usar, agrégalo con un clic, y ajústalo a tu espacio de trabajo. La forma más rápida de ver cómo se ve un buen agente.
  </Card>
  <Card title="Crea el tuyo propio" href="/agents/create" icon="plus">
    Escribe la instrucción, elige el disparador, elige dónde reporta, y define qué puede tocar.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Ejecuciones" href="/agents/runs" icon="history">
    Lee el historial, ejecuta una manualmente, y entiende qué te está diciendo una ejecución fallida.
  </Card>
  <Card title="MCP" href="/mcp" icon="plug">
    El otro lado del mismo espacio de trabajo, para cuando quieres preguntar en lugar de que te lo digan.
  </Card>
  <Card title="Base de conocimiento" href="/knowledge-base" icon="book-open">
    Otorga a un agente acceso de lectura a tus documentos para que sus reportes puedan citarlos.
  </Card>
</CardGroup>
