> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Internal links on these pages omit the .md extension. Append .md to a docs page URL, or send an Accept: text/markdown header, to get that page as markdown.

# Acerca de los agentes

> Define agentes de IA con archivos de configuración locales

<div className="dev-docs-banner">
  <div className="dev-docs-banner-content">
    <div className="dev-docs-banner-title">
      Estás viendo la documentación para desarrolladores
    </div>

    <div className="dev-docs-banner-text">
      Esta documentación es para desarrolladores que trabajan con la plataforma para desarrolladores de Base44. Para información sobre los agentes de IA en el editor de apps, consulta <a href="/Building-your-app/AI-agents-for-apps">Configurar un agente de IA</a>.
    </div>
  </div>
</div>

Los [agentes de IA](/es/Building-your-app/AI-agents-for-apps) son asistentes de IA personalizables. Realizan acciones y se conectan a herramientas para ayudar a los miembros del equipo y a los usuarios finales. Define el comportamiento, los permisos y las herramientas del agente con archivos de configuración JSONC locales.

## Crear agentes

Crea archivos de configuración JSONC en tu directorio `base44/agents/` (un archivo por agente). Luego ejecuta [`agents push`](/es/developers/references/cli/commands/agents-push) para sincronizarlos con Base44.

## Ejemplo

```jsonc theme={null}
{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent. Help users resolve their issues politely and efficiently. If you cannot help, escalate to a human agent.",
  "model": "claude-sonnet-5",
  "tool_configs": [
    {
      "entity_name": "tickets",
      "allowed_operations": ["read", "create", "update"],
    },
    {
      "entity_name": "customers",
      "allowed_operations": ["read"],
    },
    {
      "function_name": "send_notification",
      "description": "Sends a push notification to the customer",
    },
    {
      "function_name": "escalate_to_human",
      "description": "Escalates the conversation to a human support agent",
    },
  ],
  "whatsapp_greeting": "Hi, I'm your support assistant. How can I help you today?",
  "selected_skill_names": ["refund-policy", "brand-voice"],
}
```

## Referencia de campos

Las configuraciones de agentes usan JSONC. Cada agente se define en un archivo separado en el directorio `base44/agents/`.

### Campos obligatorios

<ResponseField name="name" type="string" required>
  Identificador único del agente. Usa letras minúsculas y guiones bajos. El
  nombre debe coincidir con el nombre del archivo. Por ejemplo, un agente llamado
  `customer_support` estaría en `customer_support.jsonc`.
</ResponseField>

<ResponseField name="description" type="string" required>
  Breve descripción de lo que hace el agente.
</ResponseField>

<ResponseField name="instructions" type="string" required>
  Prompt del sistema que define el comportamiento, la personalidad y las pautas del agente.
</ResponseField>

<ResponseField name="model" type="string" required>
  El modelo de IA con el que funciona el agente. Usa `automatic` para que Base44 elija uno. También puedes indicar un ID predefinido de la lista de [modelos compatibles](/es/developers/backend/resources/models), por ejemplo `claude-sonnet-5` o `gpt_6_sol`.

  Los ID predefinidos retirados que Base44 aún reconoce se actualizan automáticamente a un reemplazo actual.
</ResponseField>

### Campos opcionales

<ResponseField name="tool_configs" type="array">
  Herramientas que el agente puede usar para interactuar con tu app. Consulta
  [Configuración de herramientas](#tool-configuration).
</ResponseField>

<ResponseField name="whatsapp_greeting" type="string">
  Mensaje de bienvenida para las conversaciones de WhatsApp con este agente.
</ResponseField>

<ResponseField name="selected_skill_names" type="array">
  Nombres de las [habilidades de agente](/es/developers/backend/resources/agents/agent-skills)
  asociadas a este agente. Hasta 10 habilidades por agente.
</ResponseField>

## Configuración de herramientas

El array `tool_configs` define las capacidades de tu agente. Hay dos tipos: **herramientas de entidad** y **herramientas de función**.

### Herramientas de entidad

Las herramientas de entidad permiten al agente realizar operaciones CRUD en las [entidades](/es/developers/backend/resources/entities/overview) de tu app.

<ResponseField name="entity_name" type="string" required>
  Nombre de la entidad. Debe coincidir con una entidad existente en tu app.
</ResponseField>

<ResponseField name="allowed_operations" type="array" required>
  Operaciones que el agente puede realizar en esta entidad. Los valores válidos son `"read"`,
  `"create"`, `"update"` y `"delete"`.
</ResponseField>

### Herramientas de función

Las herramientas de función permiten al agente invocar las [funciones de backend](/es/developers/backend/resources/backend-functions/overview) de tu app.

<ResponseField name="function_name" type="string" required>
  Nombre de la función. Debe coincidir con una función existente en tu app.
</ResponseField>

<ResponseField name="description" type="string" required>
  Descripción de lo que hace la función. El agente la usa para decidir cuándo
  llamarla.
</ResponseField>

## Tipos de TypeScript

Genera tipos de TypeScript a partir de las configuraciones de tus agentes. Así obtienes seguridad de tipos y autocompletado para los nombres de agentes en tu código del SDK. Obtén más información sobre los [tipos dinámicos](/es/developers/references/sdk/getting-started/dynamic-types).

## Ver también

* [`agents pull`](/es/developers/references/cli/commands/agents-pull): Sincroniza las configuraciones de agentes de Base44 con tu proyecto local
* [`agents push`](/es/developers/references/cli/commands/agents-push): Despliega las configuraciones locales de tus agentes en Base44
* [Habilidades de agente](/es/developers/backend/resources/agents/agent-skills): Define conjuntos de instrucciones reutilizables para tus agentes
* [`agents`](/es/developers/references/sdk/docs/interfaces/agents): Referencia del SDK para trabajar con agentes en tu código
* [Configurar agentes de IA](/es/Building-your-app/AI-agents-for-apps): Guía para crear y configurar agentes de IA

<Note>Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](/). </Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.