Proteja as chaves da API da OpenAI na triagem do suporte ao cliente
Um fluxo prático de segurança para usar a OpenAI na triagem do suporte ao cliente: proteja as chaves da API, mascare os registros, limite as permissões, alterne as credenciais e exija aprovação humana.
Resumo · TL;DR
Na triagem do suporte ao cliente, mantenha a chave de aplicação da OpenAI em um componente confiável no servidor, envie apenas os detalhes mínimos e mascarados do caso, registre decisões em vez de segredos ou conversas completas e exija que uma pessoa aprove as ações voltadas ao cliente. Use credenciais separadas, com o menor privilégio necessário, para diferentes cargas de trabalho e documente como alterná-las ou revogá-las.
Principais pontos
- Não coloque uma chave de API de aplicação em código gerado por agentes, no navegador, em uma imagem de contêiner, no controle de versão ou em registros.
- Masque informações pessoais e secretas antes de enviar um caso de suporte a um modelo; depois, também minimize o que você retém.
- Deixe o modelo sugerir uma categoria, prioridade e rascunho — não encerrar casos, emitir reembolsos ou enviar respostas sem aprovação humana.
- Separe as credenciais por carga de trabalho, conceda apenas as permissões de API necessárias e ensaie a alternância e a revogação das chaves.
Nesta página (7)
O padrão mais seguro: deixar o modelo aconselhar, não agir
Na triagem do suporte ao cliente, o primeiro passo mais útil costuma ser classificar e resumir — não resolver casos de forma autônoma. Um modelo pode sugerir uma fila, um nível de urgência e um resumo preliminar, enquanto um agente de suporte verifica as evidências e decide o que fazer em seguida.
Mantenha a chave de aplicação da OpenAI em um serviço confiável no servidor, responsável por fazer a solicitação à API. Não a exponha ao navegador do cliente nem a código executado em um ambiente de agente. O guia de segurança do sandbox da OpenAI alerta que o código gerado por agentes pode acessar arquivos, credenciais e recursos de rede disponíveis no ambiente. O guia recomenda manter a chave de aplicação fora desse ambiente e não incluir chaves no código-fonte, em imagens ou em registros. Orientações de segurança do sandbox da OpenAI
Os exemplos abaixo são ilustrativos, não configurações testadas. Adapte-os ao cliente de API, aos requisitos de privacidade e ao sistema de suporte que você utiliza.
Um fluxo mínimo de triagem
- Seu sistema de suporte recebe um caso e remove os campos desnecessários para a triagem.
- Um back-end confiável mascara os valores sensíveis e envia o texto restante à OpenAI usando uma credencial mantida no servidor.
- O modelo retorna uma categoria proposta, uma prioridade e um breve resumo.
- Seu aplicativo apresenta a proposta a um agente de suporte autorizado. O agente aprova ou edita a ação seguinte.
- Seu sistema registra a decisão e os metadados de auditoria necessários, sem reter segredos nem duplicar desnecessariamente a conversa completa.
Por exemplo, o back-end pode enviar um prompt deliberadamente restrito e um caso mascarado. Evite incluir senhas, dados de cartões de pagamento, tokens de autenticação ou histórico de conta sem relação com o caso. As regras de mascaramento devem ser aplicadas antes da solicitação, não apenas ao gravar os registros posteriormente.
# Illustrative pseudocode: provide an already-redacted case to your API client.
# Keep credential loading and the API call in a trusted backend service.
def propose_triage(api_client, redacted_case):
response = api_client.create_response(
instructions=(
"Suggest a support category, priority, and concise summary. "
"Do not claim to have resolved the case or send a reply. "
"If information is insufficient, say what is missing."
),
input=redacted_case,
)
return response
Este esboço não é um exemplo pronto para uso do SDK da OpenAI: os nomes dos métodos e os campos da solicitação dependem do cliente e do endpoint da API que você utiliza. Antes da implementação, consulte a referência atual da API para verificar o endpoint, os parâmetros compatíveis e o formato da resposta. Não trate a saída do modelo como autorização para executar uma ação de suporte.
Mantenha separadas as chaves e as permissões
Sempre que possível, use credenciais separadas para aplicativos ou cargas de trabalho distintos. Isso limita o alcance de um erro e facilita revogar uma credencial sem interromper serviços não relacionados. Restrinja o acesso ao sistema que precisa da chave; mantenha-a em um repositório de segredos gerenciado ou em outro mecanismo protegido equivalente no servidor e disponibilize-a apenas ao componente confiável que faz a solicitação.
Para o ambiente da Agents API descrito nas orientações da OpenAI, a chave de aplicação precisa de api.agents.read e api.agents.write para sessões, além de api.responses.write para inferência. O gerenciamento de cofres exige api.vaults.read e api.vaults.write. O guia diferencia a chave de ambiente da chave de aplicação: a chave de ambiente permite conectar ambientes e não pode autorizar outras ações da API. Siga as permissões necessárias para os recursos da API que você realmente usa; não conceda permissões de cofre a um serviço de triagem que não gerencia cofres.
Se um ambiente de agente ou sandbox estiver envolvido, trate tudo o que estiver disponível para o código como acessível ao código gerado por agentes. Para credenciais de terceiros, as orientações recomendam mantê-las fora do ambiente e usar, conforme adequado, um proxy confiável ou uma abordagem baseada em cofres. Um segredo disponibilizado no ambiente continua acessível ao código executado nele.
Mascare os registros sem perder valor de auditoria
Os registros ajudam a investigar classificações incorretas, problemas de acesso e incidentes, mas não devem se tornar uma segunda cópia da caixa de entrada do suporte. Evite registrar chaves de API, cabeçalhos de autorização, prompts completos, mensagens originais de clientes ou respostas do modelo que possam repetir detalhes sensíveis.
Prefira registros estruturados e limitados, como uma referência interna do caso, o horário da solicitação, o identificador do modelo ou endpoint, o status do mascaramento, a categoria proposta, a decisão humana e a classe do erro. Controle o acesso a esses registros e defina períodos de retenção. Se os revisores precisarem de conversas de exemplo para verificações de qualidade, crie um conjunto de dados minimizado e com governança própria, em vez de reter silenciosamente os dados enviados em produção.
O mascaramento pode falhar quando dados pessoais aparecem em texto livre, cadeias de e-mail citadas, anexos ou formatos incomuns. Teste as regras com casos realistas, inspecione o que sai do seu sistema e ofereça uma alternativa segura quando o serviço não conseguir remover informações sensíveis com confiança.
Defina um procedimento de alternância e revogação
Um plano de alternância deve indicar um responsável e especificar onde a credencial é armazenada, quais serviços a utilizam, quem pode substituí-la e como verificar a alteração. Um procedimento prático é:
- Crie uma credencial substituta com apenas as permissões necessárias.
- Atualize o repositório de segredos do serviço confiável e implante ou recarregue a credencial por meio do processo normal de alterações.
- Verifique se uma solicitação de triagem inofensiva é concluída sem expor a credencial em diagnósticos.
- Revogue a credencial antiga e confirme que o serviço não depende mais dela.
- Registre a data, o responsável, a carga de trabalho afetada e o resultado — nunca o valor do segredo.
Defina uma periodicidade de revisão adequada aos requisitos de risco e operação da sua organização. Revogue uma chave imediatamente se houver suspeita de exposição; não espere pela próxima alternância programada. As orientações da OpenAI recomendam explicitamente alternar ou revogar as chaves quando necessário e revogar as credenciais imediatamente quando houver suspeita de exposição.
Aprovação humana e tratamento de falhas
Faça da aprovação uma regra do sistema, não apenas uma instrução no prompt. Neste fluxo, o modelo não deve ter acesso direto a ferramentas que enviem mensagens a clientes, alterem o status de contas ou emitam reembolsos. Apresente a sugestão como uma proposta, mostre as evidências relevantes já mascaradas e exija que uma pessoa autorizada confirme qualquer ação de impacto significativo.
Se a API estiver indisponível, a resposta estiver malformada ou o mascaramento falhar, encaminhe o caso para a fila manual existente. Não transforme silenciosamente uma classificação incerta em uma ação automática.
Lista de verificação
- A chave de aplicação permanece em um back-end confiável, não no navegador nem em um ambiente de agente.
- As credenciais são separadas por carga de trabalho e limitadas às permissões necessárias.
- Os campos sensíveis são removidos antes da inferência e excluídos dos registros de rotina.
- A saída da triagem é consultiva; uma pessoa aprova ações voltadas ao cliente ou que alterem contas.
- Um responsável designado pode substituir ou revogar credenciais, e o procedimento foi ensaiado.
- Falhas e resultados incertos são encaminhados a um processo manual seguro.
A decisão central de projeto é manter as credenciais e as ações de impacto significativo fora do alcance do modelo. Use o modelo para organizar o trabalho de suporte, minimize os dados aos quais ele tem acesso e faça da aprovação humana a etapa final.
Perguntas frequentes
Posso colocar uma chave da API da OpenAI em um sandbox de agente?
Evite colocar a chave de aplicação em um ambiente de agente. As orientações de segurança do sandbox da OpenAI dizem que o código gerado por agentes pode acessar os arquivos, as credenciais e a rede do ambiente e recomendam manter a chave de aplicação fora dele. Use um back-end confiável para fazer as solicitações à API.
O que os registros da triagem do suporte ao cliente devem conter?
Mantenha apenas os metadados necessários para as operações e a auditoria, como uma referência interna do caso, a data e hora, o status do mascaramento, a categoria proposta, a decisão humana e a classe do erro. Evite registrar chaves de API, cabeçalhos de autorização, mensagens completas de clientes e saídas sensíveis do modelo.
O modelo deve enviar uma resposta de suporte automaticamente?
Em um fluxo de triagem com aprovação humana, não. Use a saída do modelo como sugestão e exija que um agente de suporte autorizado revise e aprove ações voltadas ao cliente ou que alterem contas.
Quando devo alternar uma chave da API da OpenAI?
Defina uma periodicidade de revisão adequada aos seus requisitos de risco e operação e alterne as credenciais quando necessário. Se houver suspeita de exposição, revogue a credencial imediatamente e siga o procedimento de substituição e verificação.
Artigos relacionados
Guides
Como diagnosticar incidentes na API da OpenAI sem expor credenciais
Um guia prático para diagnosticar falhas na API da OpenAI com sinais úteis, protegendo chaves de API, limitando permissões e planejando a rotação de credenciais.
Guides
Diagnosticar falhas da OpenAI API em um fluxo de triagem de suporte com aprovação humana
Um guia prático para lidar com erros de autenticação, limites de taxa, timeouts e respostas malformadas do modelo sem deixar que falhas na triagem cheguem aos clientes.
Guides
Proteja as chaves da API da OpenAI em um fluxo de perguntas e respostas sobre documentos
Um padrão prático de segurança para responder a perguntas sobre documentos com a OpenAI: separe credenciais, restrinja permissões, oculte dados nos logs e faça a rotação segura das chaves, preservando a atribuição das fontes.
Guides
Como diagnosticar com segurança erros de autenticação, limite de taxa, timeout e resposta malformada da API da OpenAI
Um guia prático e atento à privacidade para diagnosticar falhas de autenticação, limitação de solicitações, timeout e resposta malformada na API da OpenAI sem expor credenciais nem dados de usuários.