Pré-requisitos#
Antes de configurar recursos de IA no Apidog, certifique-se de que você tenha:Uma conta Apidog com função de administrador de organização ou equipe (ou superior)
Cliente Apidog versão 2.7.18 ou posterior
Uma chave de API de um provedor de modelo de IA compatível (OpenAI, Anthropic, Google AI Studio, Google Vertex ou um provedor personalizado)
Somente administradores de organização ou equipe (ou funções superiores) podem configurar recursos de IA.
Visão geral#
Os recursos de IA no Apidog ficam desativados por padrão. Para habilitá-los, acesse "Configurações de organização/equipe – Recursos de IA" e ative-os. Uma vez habilitados, todos os projetos dentro da sua organização ou equipe poderão começar a usar IA para aumentar a produtividade.Configurar provedores de modelo#
Depois que os recursos de IA forem habilitados, você verá uma opção para configurar provedores de modelo. Clique em + Adicionar provedor para iniciar a configuração.Atualmente, o Apidog oferece suporte aos seguintes provedores de modelo:| Provedor |
|---|
| OpenAI |
| Anthropic |
| Google AI Studio |
| Google Vertex |
| Azure OpenAI |
| Configuração de API personalizada |
Se esses provedores não atenderem às suas necessidades, você também poderá usar Configuração de API personalizada para conectar modelos de outros provedores.Configurações#
Ao adicionar um provedor de modelo, você pode personalizar as seguintes configurações:| Configuração | Descrição |
|---|
| Chave de API | Insira a chave de API fornecida pelo provedor de modelo escolhido. Use a função Test para verificar se a chave é válida. |
| URL base da API | A URL real para a qual as requisições são enviadas ao usar recursos de IA no Apidog. Para provedores integrados, preenchemos previamente a URL base — você pode editá-la conforme necessário. |
| Lista de modelos | A lista de modelos fornecidos pelo provedor de IA. Somente modelos habilitados podem ser usados para recursos de IA. Adicione modelos manualmente, se necessário. |
| Formato da API | (Somente Configuração de API personalizada) Defina o formato da requisição e da resposta. A maioria dos modelos segue o formato da OpenAI. |
Cada requisição para o modelo de IA é enviada do servidor do Apidog para esta URL base da API.
Os recursos de IA do Apidog vêm com prompts e fluxos de invocação predefinidos. Para obter os melhores resultados, certifique-se de selecionar modelos avançados e poderosos (com suporte a contexto mais longo, chamadas de função etc.; por exemplo: GPT-4.1-mini).
Definir modelo padrão#
Se um usuário não especificar um modelo ao usar recursos de IA, o Apidog usará o modelo padrão definido aqui. Você verá um menu suspenso com todos os modelos atualmente habilitados — basta escolher aquele que deseja usar por padrão.O modelo padrão é definido como "Seleção automática" por padrão, o que escolhe automaticamente um modelo disponível com base na ordem dos provedores e modelos habilitados.Se você definir um modelo específico como padrão, mas ele for desabilitado ou removido, o Apidog retornará automaticamente para "Seleção automática".Funções e prompt#
Você pode gerenciar todos os recursos de IA do Apidog e personalizar seus prompts aqui. Depois que um recurso é habilitado, você o verá aparecer na seção relevante do seu projeto. O Apidog fornece prompts padrão para cada recurso, que você pode ajustar para atender melhor às suas necessidades.A edição personalizada de prompts ainda não é compatível — aguarde futuras atualizações!
Herdar configuração de IA da organização para a equipe#
Ao usar o gerenciamento de organização, administradores ou proprietários da organização podem configurar recursos de IA no nível da organização. Essas configurações podem ser aplicadas a todas as equipes dentro da organização, ajudando você a manter consistência e simplificar o gerenciamento entre projetos.Você encontrará a mesma interface de configuração de Recursos de IA em Configurações na página de gerenciamento da organização, assim como no nível da equipe.Depois que os recursos de IA forem configurados no nível da organização, todas as equipes dentro da organização poderão herdar os provedores de modelo configurados, o modelo padrão e as funções.Regras de herança#
| Configuração | Comportamento |
|---|
| Alternâncias de recursos | Se habilitadas no nível da organização, as equipes podem ativar/desativar. Se desabilitadas no nível da organização, as equipes não podem habilitar. |
| Provedores de modelo | As equipes podem herdar da organização ou configurar de forma independente |
| Modelo padrão | As equipes podem usar o padrão da organização ou configurar o próprio |
Pontos principais sobre herança de equipes em organizações:1.
Todas as alternâncias — como chaves de recursos de IA, configurações de provedores de modelo, seleções de modelo padrão e funções — seguem a configuração da organização. Isso garante controle centralizado e consistência em todas as equipes.
2.
Os provedores de modelo podem ser herdados da organização ou configurados de forma independente por cada equipe, dependendo das suas necessidades.
3.
As equipes também podem optar por usar o modelo padrão definido no nível da organização ou configurar o próprio.
