Skip to main content
Você está vendo a documentação para desenvolvedores
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 Configurando um agente de IA.
Agentes de IA 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 para sincronizá-los com a Base44.

Exemplo

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

string
obrigatório
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.
string
obrigatório
Breve descrição do que o agente faz.
string
obrigatório
Prompt de sistema que define o comportamento, a personalidade e as diretrizes do agente.
string
obrigatório
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, 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.

Campos opcionais

array
Ferramentas que o agente pode usar para interagir com seu app. Consulte Configuração de ferramentas.
string
Mensagem de boas-vindas para conversas no WhatsApp com este agente.
array
Nomes das skills de agente vinculadas a este agente. Até 10 skills por agente.

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 do seu app.
string
obrigatório
Nome da entidade. Deve corresponder a uma entidade existente no seu app.
array
obrigatório
Operações que o agente pode executar nesta entidade. Os valores válidos são "read", "create", "update" e "delete".

Ferramentas de função

As ferramentas de função permitem que o agente invoque as funções de backend do seu app.
string
obrigatório
Nome da função. Deve corresponder a uma função existente no seu app.
string
obrigatório
Descrição do que a função faz. O agente usa essa descrição para decidir quando chamá-la.

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.

Veja também

  • agents pull: Sincronize as configurações de agentes da Base44 com seu projeto local
  • agents push: Implante as configurações de agentes locais na Base44
  • Skills de agente: Defina conjuntos de instruções reutilizáveis para seus agentes
  • agents: Referência do SDK para trabalhar com agentes no seu código
  • Configurando agentes de IA: Guia para criar e configurar agentes de IA
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.