Solucionar problemas do conector OpenAI

info

Beta

Este recurso está em Beta. Os administradores do Workspace podem controlar o acesso a este recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

Esta página descreve erros comuns que você pode encontrar com o conector gerenciado da OpenAI e como resolvê-los.

Falha na autenticação do pipeline

Causa: A OpenAI retornou uma resposta HTTP 401 ou 403. Isso geralmente significa um dos seguintes casos: a key da API de administrador não é válida, a key foi revogada ou a key é uma key de projeto ou de serviço-account em vez de uma key da API de administrador da organização com os escopos de leitura necessários.

soluções:

1. Confirme se a key de API de administrador na conexão do Unity Catalog corresponde a uma key ativa e atual na página keys de administrador da organização OpenAI.
2. Confirme se a key é uma organização key de API de administração , não uma key de API de projeto ou uma key de serviço-account. Os endpoints da API de administração exigem uma key de nível de organização.
3. Confirme se a key possui os escopos de leitura exigidos pelo conector. Consulte Configurar autenticação para OpenAI.

Se a key foi rotacionada, atualize a conexão com a nova key. Consulte Criar uma conexão OpenAI.

O pipeline atingiu o limite de taxa

Causa: A OpenAI retornou uma resposta HTTP 429. A organização atingiu seu limite de taxa da API de administrador.

Solução: O conector aguarda e tenta novamente de forma automática. Se o erro persistir em várias execuções de pipeline, reduza a frequência para programar o pipeline ou reduza o número de pipelines concorrentes que compartilham a mesma key de API de administrador da OpenAI.

API OpenAI temporariamente indisponível

Causa: A OpenAI retornou um erro de servidor transitório (HTTP 500, 502, 503 ou 504).

Solução: O conector tenta novamente de forma automática com backoff. Se o problema persistir, verifique o status do serviço da OpenAI e, em seguida, faça a execução do pipeline novamente.