Pré-requisitos#
Antes de configurar funcionalidades de IA no Apidog, certifique-se de que tem:Uma conta Apidog com a função de administrador de organização ou equipa (ou superior)
Versão do cliente Apidog 2.7.18 ou posterior
Uma chave de API de um fornecedor de modelo de IA suportado (OpenAI, Anthropic, Google AI Studio, Google Vertex ou um fornecedor personalizado)
Apenas administradores de organização ou equipa (ou funções superiores) podem configurar funcionalidades de IA.
Visão geral#
As funcionalidades de IA no Apidog estão desativadas por predefinição. Para as ativar, aceda a "Definições de Organização/Equipa – Funcionalidades de IA" e ative-as. Depois de ativadas, todos os projetos na sua organização ou equipa podem começar a utilizar IA para aumentar a produtividade.Configurar Fornecedores de Modelos#
Depois de Funcionalidades de IA estarem ativadas, verá uma opção para configurar fornecedores de modelos. Clique em + Adicionar Fornecedor para iniciar a configuração.Atualmente, o Apidog suporta os seguintes fornecedores de modelos:| Fornecedor |
|---|
| OpenAI |
| Anthropic |
| Google AI Studio |
| Google Vertex |
| Azure OpenAI |
| Configuração de API Personalizada |
Se estes fornecedores não satisfizerem as suas necessidades, também pode utilizar Configuração de API Personalizada para ligar modelos de outros fornecedores.Definições de Configuração#
Ao adicionar um fornecedor de modelos, pode personalizar as seguintes definições:| Definição | Descrição |
|---|
| Chave de API | Introduza a chave de API fornecida pelo fornecedor de modelos escolhido. Utilize a função Test para verificar se a chave é válida. |
| URL Base da API | O URL real para o qual os pedidos são enviados ao utilizar funcionalidades de IA no Apidog. Para fornecedores integrados, preenchemos previamente o URL base — pode editá-lo conforme necessário. |
| Lista de Modelos | A lista de modelos fornecida pelo fornecedor de IA. Apenas modelos ativados podem ser utilizados para funcionalidades de IA. Adicione modelos manualmente, se necessário. |
| Formato da API | (Apenas Configuração de API Personalizada) Defina o formato do pedido e da resposta. A maioria dos modelos segue o formato OpenAI. |
Cada pedido ao modelo de IA é enviado do servidor Apidog para este URL base da API.
As funcionalidades de IA do Apidog incluem prompts e fluxos de invocação predefinidos. Para obter os melhores resultados, certifique-se de que seleciona modelos avançados e poderosos (com suporte para contexto mais longo, chamada de funções, etc.; por exemplo: GPT-4.1-mini).
Definir Modelo Predefinido#
Se um utilizador não especificar um modelo ao utilizar funcionalidades de IA, o Apidog utilizará o modelo predefinido definido aqui. Verá uma lista pendente com todos os modelos atualmente ativados — basta escolher aquele que pretende utilizar por predefinição.O modelo predefinido está definido como "Seleção Automática" por predefinição, o que escolhe automaticamente um modelo disponível com base na ordem dos fornecedores e modelos ativados.Se definir um modelo específico como predefinido, mas este for desativado ou removido, o Apidog voltará automaticamente para "Seleção Automática".Funções e Prompt#
Pode gerir todas as funcionalidades de IA do Apidog e personalizar os respetivos prompts aqui. Depois de uma funcionalidade ser ativada, verá que ela aparece na secção relevante do seu projeto. O Apidog fornece prompts predefinidos para cada funcionalidade, que pode ajustar para melhor se adequarem às suas necessidades.A edição de prompts personalizados ainda não é suportada — fique atento a futuras atualizações!
Herdar Configuração de IA da Organização para a Equipa#
Ao utilizar a gestão de organização, administradores ou proprietários da organização podem configurar funcionalidades de IA ao nível da organização. Estas definições podem aplicar-se a todas as equipas sob a organização, ajudando-o a manter a consistência e a simplificar a gestão entre projetos.Encontrará a mesma interface de configuração de Funcionalidades de IA em Definições na página de gestão da organização, tal como ao nível da equipa.Depois de as funcionalidades de IA serem configuradas ao nível da organização, todas as equipas dentro da organização podem herdar os fornecedores de modelos configurados, o modelo predefinido e as funções.Regras de Herança#
| Definição | Comportamento |
|---|
| Alternadores de Funcionalidades | Se ativados ao nível da organização, as equipas podem ativar/desativar. Se desativados ao nível da organização, as equipas não podem ativar. |
| Fornecedores de Modelos | As equipas podem herdar da organização ou configurar de forma independente |
| Modelo Predefinido | As equipas podem utilizar o modelo predefinido da organização ou configurar o seu próprio |
Pontos-chave sobre a herança de equipas sob organizações:1.
Todos os alternadores — tais como interruptores de funcionalidades de IA, definições de fornecedores de modelos, seleções de modelo predefinido e funções — seguem a configuração da organização. Isto garante controlo centralizado e consistência em todas as equipas.
2.
Os fornecedores de modelos podem ser herdados da organização ou configurados de forma independente por cada equipa, dependendo das suas necessidades.
3.
As equipas também podem optar por utilizar o modelo predefinido definido ao nível da organização ou configurar o seu próprio.
