Agentes de IA

A aba Agentes de IA na seção Configurações permite conectar contas de provedores de IA externos ao projeto. Cada conta armazena uma chave de acesso, uma lista de modelos disponíveis, um modelo padrão e um limite de gastos. Esses modelos são utilizados nas funcionalidades da plataforma, por exemplo, para tradução de conteúdo, no construtor de interface e no assistente de IA.

As contas são exibidas em forma de tabela com as colunas Nome, Provedor, Marcador, Modelos e Limites, restante. Para cada registro, estão disponíveis ações de edição e exclusão.

Direitos sobre contas de IA

Os botões dependem dos direitos de administrador no grupo Configurações na aba Configuração de direitos para módulos: criação — settings.aiAccounts.create, alteração de chaves, modelos e limites — settings.aiAccounts.update, exclusão — settings.aiAccounts.delete. Sem o direito de criação, não há botão Criar conta, sem o direito de alteração não há ícone de edição, sem o direito de exclusão — ícones de exclusão. Se o formulário aberto não puder ser salvo devido a direitos, o botão Salvar estará inativo.

info

Marcador — é o identificador do sistema da conta, pelo qual ela é referenciada no código e em outros módulos. Ele só pode ser definido na criação: no modo de edição, o campo do marcador está bloqueado.

Criação de conta

Clique no botão Criar conta acima da tabela e preencha o formulário:

1. Provedor — escolha o provedor (por exemplo, OpenRouter).
2. Marcador — defina um marcador único para a conta (por exemplo, openrouter-main).
3. Nome — forneça um nome claro para exibição na lista.
4. Chave da API — se necessário, forneça a chave de acesso do provedor (campo opcional).
5. Modelos — escolha um ou mais modelos. Na lista, estão apenas os modelos que suportam chamadas de ferramentas. Os modelos recomendados são marcados com um badge verde (na interface em português — "Recomendado"). A opção Apenas gratuitos limita a lista apenas a modelos gratuitos.
6. Modelo padrão — escolha um modelo padrão entre os adicionados.
7. Limite, USD — defina um limite de gastos. A opção Sem limite em USD remove a restrição.
8. Tempo de solicitação do agente, seg (na interface em português — "Tempo de uma solicitação do agente, seg") — quanto tempo pode durar uma solicitação do agente construtor de interface. Por padrão, 300; é permitido um número inteiro a partir de 1.
9. Limite de solicitação do agente, USD (na interface em português — "Limite de uma solicitação do agente, USD") — quanto pode custar uma solicitação desse tipo. Campo vazio — sem limite.

Uma solicitação que atingir qualquer um desses dois limites resulta em falha: o construtor informa que o limite foi atingido antes que o agente encontrasse uma resposta.

Após clicar em Salvar, a conta aparece na tabela.

Edição de conta

Clique no ícone de edição na linha da conta desejada. No formulário, é possível alterar o nome, a chave, o conjunto de modelos, o modelo padrão, o limite de gastos e os limites de uma solicitação do agente.

Se a conta tiver um Limite, USD (a opção Sem limite em USD não estiver ativada), na página de edição também será exibido um bloco Uso em USD com o gasto atual e o saldo do limite, além de botões para redefinir o contador. Contas sem limite não têm esse bloco.

info

O marcador da conta não pode ser alterado — ele permanece o mesmo que foi definido na criação.

Exclusão de conta

Clique no ícone de exclusão na linha da conta e confirme a ação no diálogo que aparece. Após a confirmação, a conta desaparece da tabela, e os modelos desse provedor deixam de estar disponíveis no projeto.