Como configurar a conexão OpenAI no Lúmina Orbe
Entenda como obter sua chave da OpenAI, onde configurá-la no Lúmina Orbe, como testar a conexão e como verificar se a integração está funcionando corretamente.
O que é a conexão OpenAI?
A integração com a OpenAI permite que o Lúmina Orbe utilize recursos de inteligência artificial para executar as funções que dependem da API da OpenAI.
Para estabelecer essa comunicação, o administrador precisa fornecer ao Lúmina Orbe uma chave de API válida criada na plataforma oficial da OpenAI.
O Lúmina Orbe não inclui uma conta, créditos ou cobrança da OpenAI. Quando recursos que dependem da API forem utilizados, o próprio cliente configura sua chave na plataforma da OpenAI e é responsável por eventuais custos cobrados pela OpenAI.
O que você precisa antes de começar?
Antes de configurar a conexão no Lúmina Orbe, tenha acesso à conta da OpenAI que será utilizada para administrar a API.
- Uma conta na plataforma da OpenAI.
- Acesso à área de gerenciamento das chaves de API.
- Uma chave de API válida para utilização pelo Lúmina Orbe.
- Acesso administrativo ao Lúmina Orbe.
Não publique sua chave em páginas, imagens, documentos públicos, repositórios ou código acessível diretamente pelo navegador.
Acesse a plataforma OpenAI
A chave utilizada pelo Lúmina Orbe deve ser criada e administrada na plataforma oficial da OpenAI.
Criar uma chave de API
Na área de chaves da plataforma OpenAI, crie uma nova chave que será utilizada pelo Lúmina Orbe.
Acesse as chaves
Abra a área de gerenciamento das chaves de API da plataforma OpenAI.
Crie uma chave
Utilize a opção disponibilizada pela plataforma para criar uma nova chave.
Copie a chave
Copie a chave imediatamente e mantenha-a armazenada de forma segura.
Volte ao Lúmina Orbe
Com a chave em mãos, retorne à Central de Conexões do Lúmina Orbe.
O Lúmina Orbe não cria a chave da OpenAI. Ela é administrada diretamente na plataforma da OpenAI.
Preencher a chave no Lúmina Orbe
Depois de criar a chave na OpenAI, acesse a Central de Conexões do Lúmina Orbe e localize a seção correspondente à OpenAI.
Central de Conexões
Abra a área onde os serviços externos do Lúmina Orbe são gerenciados.
Localize OpenAI
Encontre o cartão OpenAI entre os serviços disponíveis.
Informe a chave
Cole a chave de API no campo destinado à configuração da OpenAI.
Salve
Utilize a opção para salvar a chave configurada no Lúmina Orbe.
Como testar a conexão?
Depois de salvar a chave, utilize a opção Testar conexão disponível na seção OpenAI da Central de Conexões.
O Lúmina Orbe utiliza uma solicitação à API da OpenAI para verificar se a chave configurada pode estabelecer a comunicação.
Como saber se a conexão está funcionando?
Quando a configuração estiver correta e o teste for concluído com sucesso, a Central de Conexões apresentará o serviço OpenAI como conectado.
Origem da chave no Lúmina Orbe
O Lúmina Orbe pode utilizar a chave configurada diretamente pelo plugin ou, em determinadas instalações, uma chave existente anteriormente no wp-config.php.
Caso não exista uma chave armazenada pelo plugin, o sistema pode utilizar a chave disponível no wp-config.php como fallback.
Problemas comuns
Quando a conexão não for estabelecida, verifique primeiro os pontos abaixo.
- A chave foi copiada corretamente.
- Não existem espaços adicionais antes ou depois da chave.
- A chave ainda é válida na plataforma OpenAI.
- A chave foi configurada no campo correto da Central de Conexões.
- A conexão foi testada depois que a chave foi salva.
- A conta e a organização utilizadas na OpenAI possuem acesso aos recursos necessários.
Uma chave inválida, incorreta ou sem autorização adequada pode impedir a autenticação do Lúmina Orbe.
Cuidados com a chave da OpenAI
A chave de API deve ser tratada como uma credencial privada de acesso aos serviços da OpenAI.
- Não publique a chave em páginas públicas.
- Não envie a chave em mensagens ou documentos destinados ao público.
- Não coloque a chave diretamente em código JavaScript executado no navegador.
- Se houver suspeita de exposição, revogue a chave na plataforma OpenAI e crie outra.
Acessos rápidos à OpenAI
Os links abaixo direcionam o administrador diretamente aos ambientes oficiais utilizados durante a configuração da integração.
Em resumo
A conexão OpenAI do Lúmina Orbe utiliza uma chave de API criada e administrada na plataforma oficial da OpenAI.
A integração com a OpenAI é opcional. O Lúmina Orbe não inclui uma conta ou créditos da OpenAI. O administrador utiliza sua própria conta e chave de API, sendo responsável por eventuais custos cobrados pela OpenAI.
O administrador cria a chave, copia o valor com segurança, retorna à Central de Conexões do Lúmina Orbe, informa a chave e utiliza a opção de teste para verificar a comunicação.
Quando a autenticação é aceita, o Lúmina Orbe identifica a conexão como disponível para utilização pelos recursos que dependem da OpenAI.
