> ## 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.

# Acerca de los agentes

> Define agentes de IA usando 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 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](/Building-your-app/AI-agents-for-apps) son asistentes de IA personalizables que ejecutan 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 usando archivos de configuración JSONC locales.

## Crear agentes

Crea archivos de configuración JSONC en tu directorio `base44/agents/` (un archivo por agente) y luego ejecuta [`agents push`](/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": "anthropic/claude-sonnet-4-20250514",
  "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?",
}
```

## 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 del archivo, por lo que un agente llamado `customer_support` estaría
  en `customer_support.jsonc`.
</ResponseField>

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

<ResponseField name="instructions" type="string" required>
  System prompt que define el comportamiento, la personalidad y las directrices del agente.
</ResponseField>

<ResponseField name="model" type="string" required>
  El modelo de IA a usar, en el formato `provider/model-name`.

  Modelos compatibles:

  * `anthropic/claude-sonnet-4-20250514`
  * `anthropic/claude-3-5-sonnet-20241022`
  * `openai/gpt-4o`
  * `openai/gpt-4o-mini`
</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>

## Configuración de herramientas

El array `tool_configs` define qué capacidades tiene 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 sobre las [entidades](/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 sobre 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](/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 tus configuraciones de agentes para obtener seguridad de tipos y autocompletado para los nombres de agentes en el código de tu SDK. Aprende más sobre los [tipos dinámicos](/developers/references/sdk/getting-started/dynamic-types).

## Ver también

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

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