# Recetas

> Un agente cabe en un archivo YAML — título, descripción, instrucciones y canales. Las ocho de casa, cómo subir la tuya y cómo exportar la de un agente.

URL: https://www.ghosty.studio/docs/inicio/recetas

Una **receta** es un agente en un archivo: quién es, cómo habla, qué hace y qué no, y en qué canales trabaja. Se suelta en el creador y sale un agente listo; se exporta de un agente existente y se lleva a otra cuenta o a un repo.

## El formato

Es el formato de recetas de [Goose](https://block.github.io/goose/), con una sección `x-ghosty` para lo que es nuestro:

```yaml
version: "1.0.0"
title: Soporte al cliente
description: Resuelve dudas y problemas frecuentes con la documentación del negocio.
instructions: |
  Eres el agente de soporte del negocio. Resuelves dudas de uso, problemas frecuentes y
  preguntas sobre cuentas y pagos.

  ## Cómo hablas
  Español de México, claro y paciente. Primero confirmas que entendiste el problema en una
  frase; luego das los pasos, numerados y cortos.

  ## Qué NO haces
  - No adivinas: si la documentación no lo cubre, lo dices y escalas.
  - No pides contraseñas ni datos de tarjeta.
x-ghosty:
  engine: claude
  channels: { teams: true }
```

| Campo | Qué es |
|---|---|
| `title`, `description` | Nombre y «para qué es»; se ven en la tarjeta y en la lista. |
| `instructions` | La identidad completa, en markdown. Es lo que el agente lee al arrancar. |
| `x-ghosty.engine` | `claude`, `deepseek`, `goose` o `ghosty-lite`. |
| `x-ghosty.channels` | `{ teams: true, whatsapp: true }` — dónde trabaja al nacer. |
| `settings`, `extensions` | Opcionales, del formato Goose; se conservan si vienen. |

Sin secretos: una receta nunca lleva llaves ni tokens.

## Las ocho de casa

En **Nuevo agente → Plantilla**:

| Receta | Canal | Para |
|---|---|---|
| Asistente del equipo | Teams | Documentos, resúmenes, correos y tareas del día. |
| Soporte al cliente | Teams | Dudas y problemas frecuentes con la documentación del negocio. |
| Ventas por WhatsApp | WhatsApp | Atender, cotizar, agendar; pasar con una persona cuando hace falta. |
| Citas y agenda | WhatsApp | Agendar, confirmar y reagendar: consultorio, salón, taller, despacho. |
| Cobranza y recordatorios | WhatsApp | Recordar pagos con tacto, confirmar comprobantes, escalar lo atorado. |
| Contenido y redes | Teams | Posts, correos y copys con la voz de la marca; calendario y variantes. |
| RRHH y onboarding | Teams | Políticas, prestaciones, trámites internos; guiar a quien entra. |
| Dev en el repo | Teams + editor | Programar en tu repositorio: leer, cambiar, probar, abrir PRs. Motor Goose. |

Al elegir una, el formulario se rellena y **la identidad es editable** antes de crear.

## Subir la tuya

En **Nuevo agente → Plantilla**, suelta el `.yaml` en la zona de abajo (o haz clic para elegirlo). Si un campo viene mal, el creador lo dice antes de crear. Pídele la receta a tu agente de código con el prompt de arriba: sabe el formato.

## Exportar la de un agente

En la ficha de cualquier agente, **Descargar receta** entrega su `recipe.yaml` con nombre, descripción, identidad, motor y canales, y sin secretos. Sirve para copiar un agente a otra cuenta, versionarlo en un repo o pasarlo a un cliente.

## Lo que no es una receta

Los archivos de conocimiento, las skills y los servidores MCP no viajan en la receta: son de la máquina del agente y se le dan por la [API de configuración](/docs/configurar).