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

# 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 do app, consulte <a href="/pt-BR/Building-your-app/AI-agents-for-apps">Configurando um agente de IA</a>.
    </div>
  </div>
</div>

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

## Criar agentes

Crie arquivos de configuração JSONC no diretório `base44/agents/` (um arquivo por agente). Depois, execute [`agents push`](/pt-BR/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": "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"],
}
```

## Referência de campos

As configurações de agentes 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 do agente. Use letras minúsculas e underscores. O nome
  deve corresponder ao nome do arquivo. Por exemplo, um agente chamado
  `customer_support` fica 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>
  Prompt de sistema que define o comportamento, a personalidade e as diretrizes do agente.
</ResponseField>

<ResponseField name="model" type="string" required>
  O modelo de IA em que o agente é executado. Use `automatic` para deixar a Base44 escolher um. Ou defina um ID predefinido da lista de [modelos compatíveis](/pt-BR/developers/backend/resources/models), por exemplo `claude-sonnet-5` ou `gpt_6_sol`.

  IDs predefinidos descontinuados que a Base44 ainda reconhece são atualizados automaticamente para um substituto atual.
</ResponseField>

### Campos opcionais

<ResponseField name="tool_configs" type="array">
  Ferramentas que o agente pode usar para interagir com seu app. Consulte
  [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>

<ResponseField name="selected_skill_names" type="array">
  Nomes das [skills de agente](/pt-BR/developers/backend/resources/agents/agent-skills)
  vinculadas a este agente. Até 10 skills por agente.
</ResponseField>

## Configuração de ferramentas

O array `tool_configs` define as capacidades do seu agente. Há dois tipos: **ferramentas de entidade** e **ferramentas de função**.

### Ferramentas de entidade

As ferramentas de entidade permitem que o agente execute operações CRUD nas [entidades](/pt-BR/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 executar nesta entidade. Os valores válidos são `"read"`,
  `"create"`, `"update"` e `"delete"`.
</ResponseField>

### Ferramentas de função

As ferramentas de função permitem que o agente invoque as [funções de backend](/pt-BR/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 essa descrição para decidir quando
  chamá-la.
</ResponseField>

## Tipos TypeScript

Gere tipos TypeScript a partir das configurações dos seus agentes. Assim, você tem segurança de tipos e preenchimento automático para os nomes dos agentes no código do SDK. Saiba mais sobre [tipos dinâmicos](/pt-BR/developers/references/sdk/getting-started/dynamic-types).

## Veja também

* [`agents pull`](/pt-BR/developers/references/cli/commands/agents-pull): Sincronize as configurações de agentes da Base44 com seu projeto local
* [`agents push`](/pt-BR/developers/references/cli/commands/agents-push): Implante as configurações de agentes locais na Base44
* [Skills de agente](/pt-BR/developers/backend/resources/agents/agent-skills): Defina conjuntos de instruções reutilizáveis para seus agentes
* [`agents`](/pt-BR/developers/references/sdk/docs/interfaces/agents): Referência do SDK para trabalhar com agentes no seu código
* [Configurando agentes de IA](/pt-BR/Building-your-app/AI-agents-for-apps): Guia para criar e configurar agentes de IA

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


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