AGENT.md
AGENT.md es Markdown simple. Empiézalo con un frontmatter que le ponga nombre al empleado y le dé una descripción de una línea; la tienda y la plantilla del propietario usan ambos. Luego escribe la personalidad en segunda persona: las responsabilidades del empleado, cómo trabaja y sus reglas.
--- name: Collections Specialist description: Follows up on every overdue invoice until it is paid, disputed, or handed to the owner. --- # Collections Specialist You keep receivables moving. Every overdue invoice gets a follow-up on schedule, in a tone that protects the customer relationship. ## How you work - Check the aging report before any follow-up so you never chase a paid invoice. - Escalate to the owner when a customer disputes an amount. ## Rules - Never threaten, and never mention collections agencies. - Never agree to a payment plan; propose it to the owner.
Nebo le da al empleado su personalidad al inicio de cada sesión, junto con su nombre, su descripción, los disparadores del frontmatter y la configuración que el propietario le da en Nebo: su personalidad, sus reglas y su esencia. La personalidad es privada del empleado; nunca se agrega a un prompt que compartan otros empleados.
Escribe de qué es responsable el puesto y cómo toma decisiones. No incluyas nombres de herramientas ni de productos: las herramientas del empleado vienen de sus capacidades y conexiones, y la misma personalidad debe funcionar en cualquier empresa que lo contrate.
Memoria
Cada empleado lee los datos propios del propietario y escribe solo en su propia memoria. Trabaja con la memoria mediante las herramientas remember, recall y forget. Elige cómo se guardan sus conversaciones y su memoria con memory.mode en agent.json.
| Modo | Comportamiento | Úsalo para |
|---|---|---|
single | Una conversación continua y una sola memoria. Es el valor predeterminado. | La mayoría de los puestos. |
separate | Muchas conversaciones comparten la memoria privada del empleado. Una conversación con alguien que no es el propietario, como una persona que llama o un visitante, tiene su propia memoria sellada. | Puestos que hablan con muchas personas. |
confidential | Cada conversación es un asunto sellado. Nada de lo que se aprende en una es visible en otra, incluidas las del propietario. | Asuntos de clientes que deben mantenerse separados. |
"memory": {
"mode": "separate",
"topics": [
{ "slug": "account", "description": "A customer account: balance, promises to pay, contacts, disputes" }
],
"write_bar": ["web", "external-email"],
"share_with": []
} | Campo | Significado |
|---|---|
mode | single, separate o confidential. Un context_isolated: true antiguo se interpreta como separate. |
topics | Hasta 8 pares {slug, description} que le indican al empleado qué tipos de cosas recordar. Los slugs van en minúsculas con guiones; las descripciones tienen de 1 a 120 caracteres. Slugs reservados: tacit, entity, daily, project, memory, style, artifact. |
write_bar | Una ejecución que recibió contenido de alguno de estos orígenes no puede escribir en la memoria: web, external-email, channel, document, phone, coworker. Si se omite, channel y phone quedan bloqueados en los modos separate y confidential. Una lista vacía desactiva el bloqueo. |
share_with | IDs de empleados, o *, que pueden recibir la memoria de este empleado en las respuestas que se les dan. Vacío por defecto, lo que significa que no se comparte nada. |
La capa de empresa
La capa de empresa es el conocimiento que comparten todos los empleados: el vocabulario de la empresa, las partes con las que trata, sus reglas, leyes y normas, y el material de referencia. Vive en paquetes dentro del bot. Un paquete es una carpeta con exactamente un archivo marcador, INDUSTRY.md, FRANCHISE.md o COMPANY.md, y carpetas tipificadas a su lado. Cuando las capas no coinciden, la empresa tiene prioridad sobre la franquicia, y la franquicia sobre la industria.
<data>/packs/example-co/ ├── COMPANY.md ├── vocabulary/ ├── parties/ ├── rules/ ├── laws/ │ └── refunds.md ├── standards/ ├── workflows/ └── reference/
Cada archivo de una carpeta es Markdown con frontmatter opcional. El frontmatter lleva la estructura, como el always de una regla, el id y el value de una norma o el ceiling de una ley; el cuerpo lleva la prosa. Un paquete contiene conocimiento, nunca procedimientos, así que se rechaza cualquier paquete que contenga una skill.
Leyes
El ceiling de una ley enumera las operaciones que ningún empleado puede realizar. En la capa de empresa, reserved_to: owner cambia eso: las operaciones siguen siendo posibles, pero solo con la aprobación del propio propietario, y esa aprobación nunca se puede delegar.
--- ceiling: [ledger.refund.create] reserved_to: owner --- Refunds are issued only by the owner. Employees may prepare a refund and send it to the owner for approval.
Cómo aprenden la capa los empleados
Los empleados no consultan la capa mientras trabajan. Cuando una capa cambia, cada empleado lee el cambio una vez y reescribe sus propias reglas. El propietario siempre puede editar COMPANY.md y todas las carpetas de la empresa; guardar un cambio es la forma en que el propietario establece lo que es cierto.