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

# Sobre Agentes

> Defina agentes de IA usando arquivos de configuração locais

<div className="dev-docs-banner">
  <div className="dev-docs-banner-content">
    <div className="dev-docs-banner-title">
      Você está vendo a documentação para desenvolvedores
    </div>

    <div className="dev-docs-banner-text">
      Esta documentação é para desenvolvedores que trabalham com a plataforma para desenvolvedores Base44. Para informações sobre agentes de IA no editor de apps, veja <a href="/Building-your-app/AI-agents-for-apps">Configurar um agente de IA</a>.
    </div>
  </div>
</div>

[Agentes de IA](/Building-your-app/AI-agents-for-apps) são assistentes de IA customizáveis que tomam ação e se conectam a ferramentas para ajudar membros da equipe e usuários finais. Defina o comportamento, permissões e ferramentas do agente usando arquivos de configuração JSONC locais.

## Criar agentes

Crie arquivos de configuração JSONC no seu diretório `base44/agents/` (um arquivo por agente), depois execute [`agents push`](/developers/references/cli/commands/agents-push) para sincronizá-los com a Base44.

## Exemplo

```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?",
}
```

## Referência de campos

As configurações de agente usam JSONC. Cada agente é definido em um arquivo separado no diretório `base44/agents/`.

### Campos obrigatórios

<ResponseField name="name" type="string" required>
  Identificador único para o agente. Use letras minúsculas e underscores. O
  nome deve corresponder ao nome do arquivo, então um agente chamado `customer_support` ficaria em
  `customer_support.jsonc`.
</ResponseField>

<ResponseField name="description" type="string" required>
  Breve descrição do que o agente faz.
</ResponseField>

<ResponseField name="instructions" type="string" required>
  System prompt que define o comportamento, personalidade e diretrizes do agente.
</ResponseField>

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

  Modelos suportados:

  * `anthropic/claude-sonnet-4-20250514`
  * `anthropic/claude-3-5-sonnet-20241022`
  * `openai/gpt-4o`
  * `openai/gpt-4o-mini`
</ResponseField>

### Campos opcionais

<ResponseField name="tool_configs" type="array">
  Ferramentas que o agente pode usar para interagir com seu app. Veja [Configuração de
  ferramentas](#tool-configuration).
</ResponseField>

<ResponseField name="whatsapp_greeting" type="string">
  Mensagem de boas-vindas para conversas no WhatsApp com este agente.
</ResponseField>

## Configuração de ferramentas

O array `tool_configs` define quais capacidades seu agente tem. Existem dois tipos: **entity tools** e **function tools**.

### Entity tools

Entity tools permitem que o agente realize operações CRUD nas [entidades](/developers/backend/resources/entities/overview) do seu app.

<ResponseField name="entity_name" type="string" required>
  Nome da entidade. Deve corresponder a uma entidade existente no seu app.
</ResponseField>

<ResponseField name="allowed_operations" type="array" required>
  Operações que o agente pode realizar nesta entidade. Valores válidos são `"read"`,
  `"create"`, `"update"` e `"delete"`.
</ResponseField>

### Function tools

Function tools permitem que o agente invoque as [funções de backend](/developers/backend/resources/backend-functions/overview) do seu app.

<ResponseField name="function_name" type="string" required>
  Nome da função. Deve corresponder a uma função existente no seu app.
</ResponseField>

<ResponseField name="description" type="string" required>
  Descrição do que a função faz. O agente usa isto para decidir quando
  chamá-la.
</ResponseField>

## Tipos TypeScript

Gere tipos TypeScript a partir das configurações dos seus agentes para obter segurança de tipo e autocomplete para nomes de agente no seu código do SDK. Saiba mais sobre [tipos dinâmicos](/developers/references/sdk/getting-started/dynamic-types).

## Veja também

* [`agents pull`](/developers/references/cli/commands/agents-pull): Sincronize configurações de agente da Base44 para seu projeto local
* [`agents push`](/developers/references/cli/commands/agents-push): Implante suas configurações de agente locais na Base44
* [`agents`](/developers/references/sdk/docs/interfaces/agents): Referência do SDK para trabalhar com agentes no seu código
* [Configurar agentes de IA](/Building-your-app/AI-agents-for-apps): Guia para criar e configurar agentes de IA

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>