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