Roles y especialización
Diseñe personas para agentes.
Roles y especialización es una lección gratuita de AI Prompt Engineering en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de AI Prompt Engineering, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de AI Prompt Engineering incluye 4 lecciones en total.
Por qué especializar los agentes
Un único prompt generalista que gestiona muchas preocupaciones diluye la atención y mezcla las instrucciones. Dividir una tarea en agentes especializados —cada uno con un mandato limitado, un contexto centrado y herramientas adaptadas— mejora la precisión del comportamiento y aísla los fallos.
- Alcance limitado -> mayor fiabilidad y facilidad de dirección.
- Aislamiento -> un error en un rol no corrompe los demás.
La especialización es aplicar la estrategia de divide y vencerás al diseño de prompts.
Anatomía de una persona
Una persona eficaz para un agente es mucho más que un nombre. Declara: un mandato (de qué se ocupa), límites (qué no debe hacer), entradas/salidas (su contrato) y criterios de éxito. Las personas vagas («es usted un experto servicial») no restringen suficientemente el comportamiento.
persona = {
'role': 'Researcher',
'mandate': 'Gather and cite primary sources for the question.',
'forbidden': 'Do not draw final conclusions; do not write prose.',
'output': 'JSON list of {claim, source_url, confidence}.'
}Una única responsabilidad por agente
Dé a cada agente una sola razón para cambiar su comportamiento. Un agente que «investiga, resume y verifica hechos» combina tres objetivos que tiran en direcciones distintas. Sepárelos para que cada uno pueda ajustarse, evaluarse y depurarse de forma independiente.
La prueba es la siguiente: si no puede describir el trabajo de un agente en una sola frase sin usar «y», está haciendo demasiado.
Contexto y herramientas con alcance limitado
La especialización incluye el aislamiento del contexto. Un agente programador necesita el código y la especificación, no el documento de marketing. Restringir el contexto de cada agente reduce las distracciones, el coste y la probabilidad de que actúe basándose en material irrelevante.
- Proporcione únicamente las entradas que requiera el mandato.
- Conceda solo las herramientas que el rol utilice legítimamente.
El principio de mínimo contexto y mínimas herramientas es el equivalente multiagente del principio de mínimo privilegio.
agents = {
'coder': {'context': ['spec', 'repo'], 'tools': ['edit', 'run_tests']},
'reviewer': {'context': ['diff', 'style_guide'], 'tools': ['comment']}
}Complementarios, no redundantes
Los roles deben dividir el trabajo sin solapamientos ni vacíos. Los solapamientos desperdician capacidad de cómputo y generan resultados contradictorios; los vacíos dejan partes de la tarea sin responsable. Diseñe el conjunto de roles como una división clara en la que cada subtarea tenga exactamente un responsable.
Dibuje primero el mapa de responsabilidades y, después, escriba las personas para completar cada celda.
Roles adversariales y de crítica
Algunos de los especialistas más valiosos son adversariales: un Crítico que encuentra fallos, un agente de Red Team que ataca el plan y un Verificador que exige pruebas. Su mandato consiste explícitamente en discrepar, lo que contrarresta la complacencia y el exceso de confianza de un agente aislado.
Asocie cada generador con un escéptico cuyo éxito se mida por los problemas que encuentre.
critic = {
'role': 'Critic',
'mandate': 'Find the strongest objection to the proposal.',
'output': '{weaknesses: [...], severity: low|med|high}',
'note': 'You are rewarded for valid flaws, not agreement.'
}Estabilidad y deriva de la persona
Durante una sesión larga, un agente puede desviarse de su personaje al absorber el tono o los objetivos de otros agentes cuyos textos lee. Refuerce su identidad: repita el mandato en cada invocación y mantenga el prompt de cada agente autocontenido para que no herede silenciosamente las instrucciones de otro.
Trate la persona como algo que se reafirma en cada turno, no como algo que se configura una vez y se olvida.
Contratos de salida entre roles
Los especialistas deben realizar entregas claras. Defina un contrato tipado para la salida de cada rol que consuma el rol siguiente. Las entregas en prosa imprecisa provocan malentendidos; los contratos estructurados hacen que el flujo sea componible y verificable.
El Investigador emite afirmaciones con citas; el Redactor consume exactamente ese formato; el Crítico lo comprueba.
researcher_out = {'claims': [{'text': str, 'source': str, 'confidence': float}]}
# Writer input MUST equal researcher_out — contract enforced.Coste y latencia de la especialización
Más agentes implican más llamadas. La especialización intercambia la eficiencia de una sola llamada por fiabilidad y paralelismo. Justifique cada rol: si dividirlo no mejora la calidad de forma medible ni permite trabajar en paralelo, vuelva a integrarlo en un agente generalista.
- Los especialistas paralelizables pueden ejecutarse simultáneamente -> se reduce la latencia.
- Los especialistas estrictamente secuenciales añaden latencia -> asegúrese de que la mejora de calidad lo compense.
Elección de la granularidad adecuada
Con muy pocos roles tendrá un generalista confuso; con demasiados, se ahogará en los costes de coordinación. Elija la división más general que permita a cada agente mantener una responsabilidad única y evaluable. Empiece con una división amplia y separe un rol solo cuando las evaluaciones demuestren que está sobrecargado.
La granularidad se ajusta empíricamente, guiándose por los puntos en los que realmente se concentran los errores.
Lista de comprobación para diseñar personas
Para cada agente, confirme que cuenta con: un mandato de una sola frase, límites explícitos, alcance restringido al mínimo contexto y las mínimas herramientas, un contrato de salida tipado, un encaje complementario sin solapamientos ni vacíos, refuerzo de la identidad en cada turno y una justificación de que la división mejora la calidad o el paralelismo. Los críticos adversariales se ganan su lugar al encontrar fallos reales.
Comprobación rápida
Observa que un agente que investiga, redacta y verifica hechos produce resultados incoherentes y difíciles de depurar.
Resumen: roles y especialización
Divida las tareas en agentes con una única responsabilidad, cada uno con un mandato claro, límites explícitos, un alcance restringido al mínimo contexto y las mínimas herramientas y un contrato de salida tipado. Distribuya el trabajo claramente, sin solapamientos ni vacíos; asocie los generadores con críticos adversariales; refuerce la identidad de la persona en cada turno y elija la granularidad más amplia que mantenga todos los roles evaluables. La especialización aporta fiabilidad y paralelismo a cambio de más llamadas: inviértala donde ayude de forma medible.
Preguntas frecuentes
¿La lección «Roles y especialización» es gratis?
Sí — el texto completo de «Roles y especialización» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de AI Prompt Engineering, actualiza a CoddyKit PRO. El curso de AI Prompt Engineering incluye 4 lecciones en total.
¿Qué aprenderé en «Roles y especialización»?
Diseñe personas para agentes. Practicas AI Prompt Engineering con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar AI Prompt Engineering?
No se requiere experiencia previa. AI Prompt Engineering en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «Roles y especialización»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de AI Prompt Engineering?
Sí. Cada lección de AI Prompt Engineering incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Roles y especialización
- Orquestador y workers
- Comunicación entre agentes
- Agentes que debaten y votan