Configurar Chaves de API para Azure OpenAI

[Discourse]

Este guia explica como configurar chaves de API para o Azure OpenAI para habilitar recursos de IA do Discourse que exigem chaves de LLM de terceiros.

Nível de usuário necessário: Administrador

Neste exemplo, estamos usando o Azure OpenAI para gerar as chaves.

Nota: Você provavelmente precisará de um plano pago e terá que pagar por uso. Veja aqui os detalhes e preços mais recentes.

As plataformas estarão sempre mudando, então este guia pode não refletir 100% do processo.

Para usar certos módulos de IA, os usuários devem ter uma Chave de API de um provedor terceirizado, como OpenAI (ChatGPT), Anthropic (Claude), Stability AI (Stable Diffusion), etc.

Verifique cada módulo de IA para ver quais provedores terceirizados podem ser usados para ele.

Obter chaves de API

1. Siga a documentação aqui para obter as chaves de API necessárias, dependendo dos modelos OpenAI que você escolher e dos módulos/recursos de IA do Discourse que você usar
2. Assim que as chaves forem obtidas, armazene-as em um local seguro e copie-as

Adicionar uma Credencial

As chaves de API são gerenciadas centralmente por meio da página Credentials (Credenciais). Você deve criar uma credencial antes de configurar seu LLM.

1. Vá para Admin → Plugins → AI → Credentials
2. Clique em New credential (Nova credencial)
3. Dê um nome descritivo (ex: “Azure OpenAI API Key”)
4. Cole sua chave de API do Azure no campo Value (Valor)
5. Salve a credencial

Usando chaves de API para Discourse AI

1. Vá para Admin → Plugins → AI → LLMs
2. Clique no botão + New Model (+ Novo Modelo).
3. Selecione o modelo apropriado na lista.
   
   
4. Selecione Azure na lista Provider (Provedor)
5. Insira a URL of the service hosting the model (URL do serviço que hospeda o modelo)

Exemplo de URL: https://{RESOURCE_NAME}.openai.azure.com/openai/deployments/{DEPLOYMENT_NAME}/chat/completions?api-version=2024-02-15-preview onde

• RESOURCE_NAME é o nome do seu recurso Azure OpenAI
• DEPLOYMENT_NAME é o nome da sua implantação de modelo Azure OpenAI

6. Selecione a credencial que você criou anteriormente no menu suspenso de credenciais

7. Salve o LLM
   
   

[Zak]

Olá,

Estou encontrando um problema com o endpoint OpenAI Azure. Parece que ele não está funcionando como esperado para a seguinte URL:

https://***.openai.azure.com/openai/deployments/DEPLOYMENT_NAME/chat/completions?api-version=2023-07-01-preview

Onde DEPLOYMENT_NAME está definido como gpt-4-32k.

Você poderia, por favor, ajudar a resolver este problema? Qualquer orientação ou sugestão seria muito apreciada.

Além disso, tenho algumas dúvidas sobre plugins do Discourse:

1. Como fazer um Fork de um Plugin do Discourse: Você poderia fornecer instruções detalhadas ou um guia sobre como fazer um fork de um plugin existente do Discourse?
2. Testando o Plugin com Fork: Uma vez que eu tenha feito o fork de um plugin, quais são os passos para testar essa versão com fork na minha própria instância do Discourse?
3. Enviando e Ativando o Plugin: Após o teste, como posso enviar e ativar este plugin com fork na minha instância do Discourse?

Sua assistência com estas questões seria extremamente útil. Obrigado pelo seu tempo e apoio.

Atenciosamente,