Documentação

AI profiles

Um perfil é uma seleção que define o modelo para cada agente e permanece bloqueado durante toda a execução.

Um AI profile decide quais modelos executarão seu trabalho. Você escolhe um perfil para uma tarefa — não um por agente — e ele permanece fixo durante todo o fluxo de trabalho.

Um perfil é um conjunto de modelos, um para cada agente.

Esta é a parte que merece ser compreendida com atenção.

Um perfil não é um único modelo. Ele contém uma atribuição para cada função de agente: um modelo para o Arquiteto, um para o Desenvolvedor, um para QA, um para o Revisor — cada um com um modelo alternativo caso a primeira opção não esteja disponível.

O processamento específico por agente já está definido dentro do perfil. Veja o Orçamento: ele não simplesmente escolhe o modelo mais barato para tudo. Ele combina um modelo de baixo custo com amplo conhecimento geral para o arquiteto — pois o planejamento exige abrangência — com um modelo de baixo custo, mas realmente capaz, para o desenvolvedor, já que escrever código que compile é uma exigência diferente. Ambos são econômicos; nenhum é o mesmo modelo.

Portanto, escolher um perfil significa escolher um equilíbrio em todo o pipeline, não um simples controle de qualidade.

Os perfis disponibilizados

PerfilOtimizado para
OrçamentoCusto. Tarefas rotineiras, documentação e alterações simples.
Mais inteligenteCapacidade. Arquitetura, depuração e trechos críticos de código.
RápidoLatência. Trabalho iterativo onde você precisa de uma resposta imediata.
Extremamente rápidoVelocidade máxima, com critérios de qualidade menos rigorosos.
Somente UEModelos hospedados na UE, para atender às exigências de residência de dados.
GratuitoSem custo de modelo; Coroid direciona para modelos econômicos.
Baixa emissão de carbonoModelos menores em redes elétricas de menor intensidade.

O perfil fica bloqueado enquanto o trabalho é executado.

Um perfil é atribuído quando o trabalho é criado e permanece fixo assim que a execução começa.. A interface exibe um cadeado no chip do perfil enquanto uma tarefa está em execução.

Duas consequências:

  • Você pode alterá-lo quando a tarefa não estiver em execução. — antes de começar ou enquanto ela estiver parada.
  • Uma tarefa concluída mantém o perfil com o qual foi executada. O registro do que gerou uma alteração permanece preciso, e o custo de uma tarefa sempre pode ser explicado pelos modelos que foram efetivamente utilizados.

O bloqueio é importante porque um fluxo de trabalho que trocasse de modelo no meio do processo geraria um plano a partir de um modelo e uma implementação a partir de outro, sem uma explicação coerente para o aspecto do resultado.

Escolhendo um perfil

Como um único perfil cobre todo o pipeline, a questão é o que este trecho de trabalho merece:

  • Rotineiro, bem especificado e próximo de testes existentes → Orçamento.
  • Significativo em termos arquitetônicos ou em código que não pode apresentar erros → Mais inteligente.
  • Iterando e revisando de perto → Rápido ou Extremo.
  • Requisitos de residência de dados → Apenas UE.

Apenas UE e Baixo carbono

Esses dois são perfis de restrição, não níveis de qualidade.

Apenas UE restringe o roteamento aos modelos hospedados na UE. Se você possui um requisito de residência de dados, é assim que o atende — e trata-se de uma restrição real, portanto algumas funcionalidades ficam indisponíveis.

Baixo carbono prefere modelos menores em redes elétricas de menor intensidade. O Coroid informa as emissões estimadas de inferência operacional; a estimativa abrange apenas a inferência e não constitui uma afirmação de neutralidade de carbono.

Perfis personalizados

O plano Professional inclui perfis do sistema e perfis personalizados do AI. Escolher o modelo e o fallback para cada função de agente individualmente — em vez de aceitar um equilíbrio definido previamente — é uma capacidade Enterprise, atualmente em visualização privada.

Recorra a isso quando um perfil disponível for quase adequado, mas apresentar falhas em um ponto específico — por exemplo, um perfil Orçamento em todos os lugares exceto para um revisor mais rigoroso, devido às regras de revisão exigidas pela sua organização.

Utilizando suas próprias chaves

Os modelos podem ser servidos pelo Coroid ou por meio das suas próprias credenciais de provedor, e as opções de modelo de um perfil registram qual método é aplicado. No modelo BYOK, você paga diretamente ao seu provedor pelas suas tarifas, e o Coroid não adiciona nenhum acréscimo.

As chaves são criptografadas em repouso, nunca retornadas pelo API e nunca incluídas nas exportações de configurações. Consulte Chaves de provedor.

Onde alterá-las

As configurações padrão da organização ficam em Configurações → AI profile. O perfil para um trecho específico de trabalho é definido no Novo trabalho formulário, nas configurações avançadas.