Sign in
ai-agents
agents

Criar agente de IA

Cria um agente de IA. No modo manual (padrão) informe name, description, default_provider e default_model; tools aceita apenas os nomes devolvidos pelo endpoint de ferramentas disponíveis. Com auto_generate: true basta enviar description: o sistema redige nome, prompt base, ferramentas e os contextos iniciais do agente, e nesse modo a criação respeita o limite de agentes contratado, respondendo 402 quando ele já foi atingido.

post/api/management/ai/agents

Request body

namestring

Nome do agente. Obrigatório quando auto_generate é falso ou ausente.

descriptionstring required

Descrição curta do agente. No modo de geração automática é a partir dela que o agente inteiro é redigido.

default_provider'openrouter' | 'google' | 'openai' | 'anthropic'

Provedor de IA padrão do agente. Obrigatório quando auto_generate é falso ou ausente.

default_modelstring

Identificador do modelo padrão, conforme o id devolvido pelo catálogo de modelos disponíveis. Obrigatório quando auto_generate é falso ou ausente.

base_promptstring nullable

Prompt base que define o comportamento do agente.

toolsstring[] nullable

Ferramentas que o agente pode usar; nomes fora do catálogo são rejeitados.

auto_generateboolean

Quando verdadeiro, nome, prompt base, ferramentas e contextos iniciais são gerados a partir de description e os demais campos enviados são ignorados.

Response

Sucesso

responseboolean

Indicador de sucesso da requisição; sempre verdadeiro nesta resposta.

Changes