Solução de Problemas para Recursos de IA no eDirectory

Introdução

O eDirectory inclui recursos alimentados por IA que dependem de uma conexão válida com a API da OpenAI. Se houver um problema com a chave da API da OpenAI, cobrança, cota ou configuração da conta, o recurso de IA pode exibir um erro ao ser utilizado dentro da plataforma.

Na maioria dos casos, os erros relacionados à IA são causados por um dos seguintes:

• A chave da API da OpenAI é inválida ou incorreta.
• A chave da API foi copiada com espaços extras.
• A chave da API foi excluída, revogada ou regenerada.
• A conta da OpenAI atingiu sua cota de uso.
• A conta da OpenAI não possui créditos disponíveis.
• A cobrança da conta da OpenAI está inativa ou incompleta.
• A chave da API pertence a um projeto ou organização diferente da OpenAI.

Este artigo explica as causas mais comuns de erros de IA no eDirectory e os passos que você pode seguir para solucioná-los.

Sintomas Comuns

Você pode precisar revisar sua configuração do OpenAI se estiver enfrentando um dos seguintes problemas:

• Uma mensagem de erro aparece ao tentar usar um recurso de IA.
• Conteúdo gerado pela IA não é retornado.
• Sugestões de IA falham ao carregar.
• Resumos, descrições ou respostas de IA não são gerados.
• A plataforma mostra um erro após clicar em um botão de ação de IA.
• O recurso de IA estava funcionando antes, mas parou de repente.
• A integração do OpenAI foi configurada recentemente, mas os recursos de IA não funcionam.

1. Verifique se a Chave da API do OpenAI Está Correta

O primeiro passo é confirmar se a chave da API do OpenAI inserida no eDirectory é válida.

Para verificar a chave da API:

1. Faça login na sua conta da API do OpenAI.
2. Vá para a seção de chaves da API.
3. Confirme que a chave da API usada no eDirectory ainda existe e está ativa.
4. Copie a chave da API novamente diretamente do OpenAI.
5. Volte para o eDirectory e cole a chave novamente nas configurações de integração do OpenAI.
6. Salve as alterações.
7. Teste o recurso de IA novamente.

Ao copiar e colar a chave da API, certifique-se de que não haja espaços extras antes ou depois da chave. Até mesmo um espaço em branco extra pode impedir que a chave seja validada corretamente.

Se você não tem certeza se a chave atual é válida, recomendamos gerar uma nova chave da API no OpenAI e atualizá-la no eDirectory. Veja este artigo para referência: Como Integrar o Chat GPT com o eDirectory 14.0+.

2. Verifique se a Chave da API Foi Excluída ou Regenerada

Se os recursos de IA estavam funcionando antes e pararam de repente, a chave da API pode ter sido alterada no OpenAI.

Isso pode acontecer se:

• A chave da API foi excluída.
• Uma nova chave da API foi gerada, mas o eDirectory não foi atualizado.
• O proprietário da conta do OpenAI rotacionou a chave da API por motivos de segurança.
• A chave da API pertence a um projeto ou organização diferente.

Se uma chave da API for excluída ou substituída no OpenAI, a chave antiga não funcionará mais no eDirectory. Nesse caso, crie uma nova chave da API e atualize as configurações do OpenAI no seu site eDirectory.

3. Verifique a Cota e a Cobrança da Conta do OpenAI

Se a chave da API estiver correta, mas o erro continuar, o problema pode estar relacionado à cota ou à cobrança da conta do OpenAI.

Os recursos de IA exigem uso de API disponível na conta do OpenAI conectada ao eDirectory. Se a conta atingiu sua cota, limite de uso mensal ou não tem créditos disponíveis, o OpenAI pode rejeitar a solicitação e o eDirectory pode exibir um erro.

Para verificar isso:

1. Faça login na sua conta da API do OpenAI.
2. Vá para a seção de cobrança ou uso.
3. Confirme que a conta tem créditos disponíveis.
4. Confirme que o limite de uso mensal não foi atingido.
5. Confirme que a cobrança está ativa e configurada corretamente.
6. Se necessário, adicione créditos ou aumente o limite de uso.
7. Retorne ao eDirectory e teste o recurso de IA novamente.

Se a conta do OpenAI não tiver cota disponível, os recursos de IA não funcionarão até que o problema de cobrança ou uso seja resolvido diretamente no OpenAI.

4. Confirme o Projeto ou Organização OpenAI Correto

Algumas contas OpenAI podem ter acesso a múltiplos projetos ou organizações. Se a chave da API pertencer a um projeto diferente daquele com cobrança ativa ou cota disponível, a solicitação da IA pode falhar.

Por favor, confirme que:

• A chave da API pertence ao projeto OpenAI correto.
• O projeto tem cobrança habilitada.
• O projeto tem uso disponível.
• O usuário que criou a chave da API ainda tem acesso ao projeto.
• A chave da API não foi restringida de uma maneira que impeça solicitações da API.

Se você gerencia múltiplos projetos ou organizações OpenAI, recomendamos criar uma nova chave da API sob o projeto correto e atualizá-la no eDirectory.

5. Verifique o Uso Temporário ou Limites de Taxa

Em alguns casos, o problema pode ocorrer quando muitas solicitações de IA são feitas em um curto período de tempo. A OpenAI pode limitar temporariamente as solicitações se a conta atingir seu limite de taxa.

Isso pode acontecer quando:

• Várias ações de IA são acionadas rapidamente.
• Múltiplos usuários estão utilizando recursos de IA ao mesmo tempo.
• O mesmo botão de IA é clicado repetidamente.
• A conta OpenAI tem limites de uso baixos.

Se isso acontecer:

1. Espere alguns minutos.
2. Tente usar o recurso de IA novamente.
3. Evite clicar no botão de ação de IA várias vezes.
4. Verifique a página de uso e limites da OpenAI.
5. Se necessário, revise ou aumente os limites de uso da conta na OpenAI.

Se o erro ocorrer apenas ocasionalmente e funcionar novamente após esperar, pode ter sido causado por um limite de taxa temporário.

6. Gere uma Nova Chave da API

Se o problema continuar após verificar os itens anteriores, gerar uma nova chave da API é frequentemente a maneira mais rápida de resolver o problema.

Para gerar e atualizar a chave:

1. Faça login na sua conta da API OpenAI.
2. Crie uma nova chave da API.
3. Copie a nova chave.
4. Vá para as configurações de integração da OpenAI no eDirectory.
5. Substitua a antiga chave da API pela nova.
6. Salve as alterações.
7. Teste o recurso de IA novamente.

Por razões de segurança, não compartilhe sua chave completa da API OpenAI por e-mail ou em tickets de suporte.

7. Contate o Suporte se o Erro Continuar

Se o recurso de IA ainda exibir um erro após verificar a chave da API, cota, cobrança e configurações do projeto, entre em contato com nossa equipe de suporte enviando um e-mail para support@edirectory.com.

Para nos ajudar a investigar o problema mais rapidamente, inclua as seguintes informações:

• O recurso de IA que você estava tentando usar.
• A página ou seção onde o erro apareceu.
• Uma captura de tela da mensagem de erro.
• A data e hora aproximadas em que o erro ocorreu.
• Confirmação de que a chave da API OpenAI foi verificada ou regenerada.
• Confirmação de que a conta OpenAI tem créditos disponíveis e não atingiu seu limite de uso.

Por favor, não envie sua chave completa da API OpenAI no ticket. Se necessário, nossa equipe irá orientá-lo sobre como atualizar a chave com segurança nas configurações do seu eDirectory.

Conclusão

A maioria dos erros de recursos de IA no eDirectory está relacionada à conta OpenAI conectada à plataforma. As causas mais comuns são uma chave da API inválida, uma chave da API incorreta, falta de cobrança ou uma conta OpenAI que atingiu sua cota de uso.

Antes de contatar o suporte, recomendamos verificar a chave da API, confirmar que a conta OpenAI tem créditos disponíveis, revisar o projeto ou organização conectado à chave e gerar uma nova chave da API, se necessário.

Uma vez que a chave da API OpenAI e a cota da conta estejam corretamente configuradas, os recursos de IA devem funcionar normalmente novamente.