Pular para o conteúdo principal
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 de apps, veja Configurar um agente de IA.
Agentes de IA 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 para sincronizá-los com a Base44.

​
Exemplo

{
  "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

​
name
string
obrigatório
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.
​
description
string
obrigatório
Breve descrição do que o agente faz.
​
instructions
string
obrigatório
System prompt que define o comportamento, personalidade e diretrizes do agente.
​
model
string
obrigatório
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

​
Campos opcionais

​
tool_configs
array
Ferramentas que o agente pode usar para interagir com seu app. Veja Configuração de ferramentas.
​
whatsapp_greeting
string
Mensagem de boas-vindas para conversas no WhatsApp com este agente.

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

​
Function tools

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

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

​
Veja também

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