Como integrar os Conectores de IA da Udemy Business à sua ferramenta de IA

Este artigo explica como configurar os Conectores de IA da Udemy Business com sua ferramenta de IA e como solucionar problemas comuns.

Os Conectores de IA da Udemy Business via MCP (Model Context Protocol) conectam seus assistentes e agentes de IA à sua conta da Udemy Business, para que eles possam usar com segurança os dados de aprendizado da sua organização em tempo real. Com essa conexão, seus assistentes podem consultar seu catálogo, obter detalhes de cursos e trilhas, fundamentar suas recomendações com informações atualizadas do seu locatário da Udemy Business e criar trilhas de aprendizado estruturadas diretamente na conta da Udemy Business da sua organização. Para obter mais informações, consulte as perguntas frequentes sobre os Conectores de IA da Udemy. 

Índice

• Ferramentas e recursos disponíveis
• Usar create_learning_path com eficiência
• Pré-requisitos
• Como se conectar aos Conectores de IA da Udemy Business
• (Método alternativo) Criar um cliente estático na Udemy Business
• Instruções de configuração para ferramentas de IA específicas 
• Como configurar o servidor MCP da Udemy Business com o Microsoft Copilot
  • Pré-requisitos
  • Etapa de configuração
  • Atualizar o conector para acessar novas ferramentas
• Solução de problemas
  • Problemas com autenticação ou OAuth
  • Problemas com o cliente MCP 
  • Problemas com a conexão do Microsoft Copilot
  • Por que não vejo as ferramentas da Udemy listadas na minha ferramenta de IA após a configuração?
• Exemplo de prompt do sistema

Ferramentas e recursos disponíveis 

As seguintes ferramentas estão atualmente disponíveis nos Conectores de IA da Udemy Business. Todas as ferramentas requerem a assinatura do complemento Conectores de IA. A maioria das ferramentas é somente leitura e recupera informações do seu catálogo da Udemy Business. create_learning_path é a única ferramenta que escreve na sua conta; ela cria uma trilha de aprendizado na sua conta da Udemy Business.

Usar create_learning_path com eficiência

Diferente das ferramentas de busca, create_learning_path funciona melhor quando seu agente de IA está configurado para encadear várias ferramentas em sequência. Um agente bem configurado vai:

1. Pesquisar por cursos relevantes usando search_courses (e opcionalmente search_labs para temas técnicos) com base na habilidade, no público e no nível de proficiência especificados.
2. Inspecionar as grades curriculares dos cursos usando get_course_curriculum para verificar a relevância do conteúdo antes de incluir um curso na trilha.
3. Criar a trilha usando create_learning_path assim que o conteúdo correto tiver sido identificado.

Sem esse comportamento de encadeamento, o agente pode tentar criar uma trilha sem verificar o conteúdo primeiro, o que pode resultar em um resultado de qualidade inferior. Para habilitar esse comportamento, atualize o prompt do sistema do seu agente para incluir instruções explícitas sobre o processo de múltiplas etapas. Veja o exemplo de prompt do sistema abaixo para um exemplo recomendado.

Observações importantes para create_learning_path:

  • Aprovação necessária: como essa ferramenta escreve na sua conta da Udemy Business, a maioria dos sistemas de IA (incluindo Claude e ChatGPT) solicitará a confirmação do usuário antes de executá-la. Os usuários devem esperar uma etapa de aprovação antes que a trilha seja criada; esse é um comportamento esperado, não um erro.

  • Particular por padrão: trilhas criadas pelos Conectores de IA são definidas como particulares. Para atribuir ou tornar uma trilha visível para os alunos, abra-a nas suas ferramentas de administração da Udemy Business em Trilhas de aprendizado.

  • Nova ferramenta — atualização necessária: se você conectou os Conectores de IA da Udemy Business antes de create_learning_path estar disponível, você precisará atualizar ou reconectar o conector na sua ferramenta de IA para que a nova ferramenta apareça. Consulte Atualizar o conector para acessar novas ferramentas abaixo.

Pré-requisitos 

Antes de configurar esta integração, você deve ter:

• Um Plano Enterprise da Udemy Business e a compra do complemento Conectores de IA.
  • Observação: se você não vê a configuração do servidor MCP em suas ferramentas de administração, provavelmente sua organização ainda não tem acesso. Entre em contato com seu representante de Sucesso do cliente ou com o Suporte da Udemy Business para obter informações sobre como atualizar seu acesso ao servidor MCP.
• Acesso independente a uma ferramenta de IA, como ChatGPT Enterprise, Claude AI Enterprise, Cursor ou um agente de IA personalizado compatível com conectores MCP. 
  • Observação: os usuários para os quais as licenças do Conector de IA são adquiridas também devem ter acesso a uma ferramenta de IA suportada pelo MCP.

Como se conectar aos Conectores de IA da Udemy Business

Dependendo da sua ferramenta de IA, as etapas reais para configurar uma conexão com os Conectores de IA podem variar. Em geral, as etapas envolvem o seguinte, se sua ferramenta for compatível com DCR (Dynamic Client Registration, registro dinâmico de clientes):

1. Especifique o endpoint do servidor MCP: https://api.udemy.com/mcp
2. Escolha o Transporte (se disponível) como HTTP transmissível.
3. Escolha a Autenticação como OAuth/OAuth 2.1
4. Clique em Usar o Registro dinâmico de clientes (DCR).
   • Se você quiser usar credenciais de cliente estáticas e sua ferramenta de IA aceitar, veja as instruções para criar um cliente na Udemy Business, depois cole o ID do cliente e o Segredo do cliente.
5. Aceite todos os "Termos" para usar os conectores na sua ferramenta de IA.
6. Clique Conectar e isso iniciará um login na sua conta da Udemy Business via SSO ou e-mail e senha, dependendo da sua organização. Após fazer login, você deverá fornecer consentimento para permitir que a ferramenta de IA acesse sua conta da Udemy Business. Quando solicitado, clique em Aceitar para fornecer consentimento. 
   • Observação: certifique-se de confiar nas ferramentas de IA que você está conectando aos Conectores de IA da Udemy Business.

(Método alternativo) Criar um cliente estático na Udemy Business

Se você quiser usar credenciais de cliente estático para conectar sua ferramenta em vez de registro dinâmico de cliente, siga estas etapas para criar um cliente MCP na Udemy Business para gerar seu ID do cliente e Segredo do cliente.

1. Na Udemy Business, navegue até Ferramentas de administração > Configurações > Servidor MCP.

2. Clique em Criar novo cliente.

3. No menu suspenso, selecione seu aplicativo cliente, ou selecione Outro para inserir um nome de ferramenta de IA personalizada. 

4. No campo URLs de callback, insira as URLs de callback/redirect OAuth da sua aplicação. Verifique com o seu provedor de ferramentas de IA para obter as URLs de callback/redirect. Para algumas das ferramentas de IA padrão, você encontrará uma ou mais URLs de callback/redirect já inseridas. Observação: especificar explicitamente as URLs de callback/redirect garante que apenas a aplicação autorizada processe o redirecionamento. Isso mantém a integridade e a identidade das aplicações envolvidas.

5. Após clicar em Criar cliente, você receberá um ID do cliente e um Segredo do cliente. Essas credenciais permitem que sua aplicação se conecte ao servidor MCP da Udemy Business. 

Observação de segurança importante: salve o ID do cliente e o Segredo do cliente em um local seguro. Isso será necessário ao configurar a ferramenta de IA para se conectar aos Conectores de IA. Por razões de segurança, você não poderá visualizar o Segredo do cliente novamente na sua conta de administrador. Se você perder o Segredo do cliente, precisará excluir o cliente e criar um novo cliente para reiniciar a configuração.

6. Após salvar com segurança seu ID do cliente e Segredo do cliente em um local seguro, clique em Concluído. 

Instruções de configuração para ferramentas de IA específicas 

Esta seção fornece instruções para você se conectar aos Conectores de IA para obter uma amostra de ferramentas de IA.

Observação: essas instruções de configuração são de produtos externos à Udemy e são fornecidas aqui apenas como exemplos. Caso a interface do usuário da ferramenta de IA seja diferente dessas instruções, siga as orientações e a documentação fornecidas pela respectiva ferramenta de IA. 

ChatGPT

1. Navegue até Configurações > Aplicativos e Conectores > Configurações avançadas e ative o modo desenvolvedor do ChatGPT

• Observação: talvez isso precise ser executado pelo administrador do ChatGPT.

2. Na seção Configurações -> Aplicativos e Conectores do ChatGPT, clique em Criar. 

3. Forneça um nome para os Conectores de IA. Por exemplo: Udemy Business MCP.

4. Especifique o endpoint dos Conectores de IA: https://api.udemy.com/mcp

5. Escolha Registro dinâmico de cliente (DCR), então clique em Conectar.

6. Isso iniciará um login na sua conta da Udemy Business via SSO ou e-mail e senha, dependendo da sua organização. Após fazer login, você deverá fornecer consentimento para permitir que a ferramenta de IA acesse sua conta da Udemy Business. Quando solicitado, clique em "Aceitar" para fornecer consentimento.

7. Após a conexão, você verá uma lista de ferramentas disponíveis como parte dos Conectores de IA.

8. Como um administrador do ChatGPT, você poderá publicar o conector para todos os seus usuários do ChatGPT na sua empresa. Eles verão os Conectores de IA da Udemy Business na página de configurações do ChatGPT e precisarão apenas clicar em Conectar, o que os levará à etapa 6 acima.

Claude 

1. Navegue até claude.ai ou abra o aplicativo para desktop Claude.

2. Vá para Configurações da organização > Conectores > Adicionar (Todos disponíveis) e procure por Udemy Business. Adicione o conector à sua organização no Claude.

3. Após habilitar o conector para a organização, usuários individuais podem ir para suas Configurações > Conectores > Udemy Business > Conectar.

Cursor

1. Acesse Configurações > Ferramentas e integrações > Ferramentas MCP.

2. Clique em Novo servidor MCP e adicione a seguinte configuração em mcpServers:

"udemy-mcp": { "url": "https://api.udemy.com/mcp", "type": "http" }

3. Volte para a guia Ferramentas e integração e autentique a integração.

Como configurar o servidor MCP da Udemy Business com o Microsoft Copilot

O Microsoft Copilot pode acessar o conteúdo de aprendizado da Udemy Business por meio de um agente criado no Microsoft Copilot Studio. Isso requer uma licença separada do Microsoft Copilot Studio (diferente da licença padrão do Microsoft Copilot de acordo com a estrutura SKU da Microsoft). 

O agente se conecta ao servidor MCP da Udemy Business e pode ser publicado no seu locatário da Microsoft, tornando-o disponível através de canais como Microsoft Copilot Chat, Microsoft Teams e outros aplicativos Microsoft 365.

Pré-requisitos

Antes de configurar os Conectores de IA da Udemy Business com o Microsoft Copilot, você precisará de:

• Uma licença do Microsoft Copilot Studio
• Acesso administrativo ao Microsoft Copilot Studio
• Acesso administrativo à conta da Udemy Business da sua organização
• Plano Enterprise da Udemy Business com assinatura do complemento Conectores de IA

Etapas da configuração

Etapa 1: crie um agente no Microsoft Copilot Studio

1. Navegue até o Microsoft Copilot Studio e crie um novo agente.
2. Forneça um nome para o seu agente. Exemplo: Agente de descoberta de habilidades da UB
3. Insira instruções do sistema que definem como o agente deve se comportar e como você gostaria que os resultados da ferramenta fossem formatados.  
   • Confira um exemplo de prompt do sistema.

Etapa 2: adicione o Servidor MCP da Udemy Business como uma Ferramenta

1. Navegue até a guia Ferramentas no seu agente.
2. Clique Adicionar uma ferramenta.
3. Selecione o Protocolo de Contexto do Modelo nas opções de ferramentas disponíveis.

Etapa 3: configure a conexão do servidor MCP

Na janela de configuração do servidor MCP, preencha os seguintes detalhes:

1. Nome do servidor: insira um nome descritivo (MCP da Udemy)
2. Descrição do servidor: adicione uma descrição
3. URL do servidor: https://api.udemy.com/mcp
4. Autenticação: selecione OAuth > Descoberta dinâmica
5. Clique em Criar.

.

Etapa 4: crie e autentique a conexão

1. Após criar a ferramenta, você verá uma janela pop-up Conexão.

2. Clique no ícone de conexão e selecione Criar nova conexão. 

   

3. Clique em Criar.
4. Você acessará a tela de login da Udemy Business.
5. Faça login na sua instância da Udemy Business usando suas credenciais.
6. Forneça consentimento para o Microsoft Copilot Studio acessar sua conta da Udemy Business.

Etapa 5: verifique as ferramentas conectadas

Após estabelecer a conexão, você deve ver as ferramentas disponíveis da Udemy Business listadas sob o servidor MCP conectado.

Etapa 6: publique o agente

1. Após criar o agente e configurar as ferramentas com sucesso, clique em Publicar. 

2. Ajuste as configurações de Compartilhamento apropriadas para tornar o agente disponível para os usuários do seu locatário.

3. Sob a guia Canais, selecione os canais onde você deseja que este agente esteja disponível (por exemplo, Microsoft Copilot Chat, Microsoft Teams, SharePoint etc.)

Etapa 7: acesse o agente

Após publicar, seus usuários do Copilot Chat podem interagir com o agente das seguintes maneiras:

• Digitando @agentName no Copilot Chat (substitua agentName pelo nome do seu agente).

  

Exemplo de um chat com o agente:

Nota de autenticação importante

O servidor MCP da Udemy Business requer autenticação OAuth. Os usuários finais precisarão fazer login e fornecer consentimento para que as ferramentas do agente funcionem corretamente. Verifique com sua equipe de TI para entender como a autenticação está configurada para os usuários do seu locatário Microsoft ao acessar conectores OAuth com agentes criados no Copilot Studio.

Atualizar o conector para acessar novas ferramentas

Se você conectou os Conectores de IA da Udemy Business antes que uma nova ferramenta fosse adicionada, sua ferramenta de IA pode ou não detectar automaticamente a lista de ferramentas atualizada. A maioria das ferramentas de IA permite que você atualize a lista de ferramentas para buscar novas ferramentas ou elas podem fazer isso automaticamente quando você inicia uma nova conversa ou sai e entra novamente.

Após reconectar, verifique se create_learning_path aparece na sua lista de ferramentas ao lado das ferramentas de busca existentes.

Solução de problemas 

Esta seção fornece dicas de solução de problemas para alguns problemas comuns com os Conectores de IA. Se você não conseguir resolver o problema, entre em contato com o Suporte da Udemy Business.

Observação: se você estiver tendo problemas durante a configuração, certifique-se de que sua organização, sua conta de administrador e sua ferramenta de IA escolhida atendam aos pré-requisitos estabelecidos no início deste artigo. 

Problemas com autenticação ou OAuth

• Verifique novamente o ID do cliente e o Segredo do cliente.
• Desvincule a conexão dos Conectores de IA e, em seguida, repita o processo OAuth para autenticar novamente.
• Desconecte-se da sua conta Udemy Business e, em seguida, faça login novamente. 
• Após efetuar alterações de configuração, pode ser necessário reiniciar os aplicativos desktop para que as atualizações entrem em vigor.

Problemas com o cliente dos Conectores de IA 

• Se a ferramenta dos Conectores de IA da Udemy Business não estiver funcionando no Cursor, isso pode ser causado por tokens de autenticação expirados ou incorretos. Para corrigir isso:
  1. Na Paleta de comandos, pesquise e selecione Limpar todos os tokens MCP.
  2. Reautentique suas contas.
• Quando as consultas falharem devido a timeouts, considere simplificar ou dividir solicitações maiores em entradas menores e mais gerenciáveis. 
• Quando você encontrar erros relacionados a limites de tokens, considere iniciar um novo tópico de conversa ou ajustar o limite de tokens nas configurações do seu cliente MCP. 
• Se as ferramentas não carregarem, reiniciar o aplicativo cliente MCP e fazer login novamente deve resolver o problema.
• create_learning_path mostra um prompt de confirmação antes de executar.
  • Esse é o comportamento esperado. Como essa ferramenta cria conteúdo na sua conta da Udemy Business, sua ferramenta de IA exigirá que você aprove a ação antes que ela seja executada. Clique em Permitir ou Confirmar quando solicitado para prosseguir com a criação da trilha.

Problemas com a conexão do Microsoft Copilot

• Se as ferramentas do agente não estiverem funcionando, verifique se os usuários finais completaram o fluxo de login e consentimento do OAuth.
• Verifique com sua equipe de TI sobre as políticas do conector OAuth em seu locatário do Microsoft.
• Certifique-se de que sua licença do Microsoft Copilot Studio esteja ativa e devidamente configurada.

Por que não vejo as ferramentas da Udemy listadas na minha ferramenta de IA após a configuração?

• Confirme a conexão ao endpoint correto dos Conectores de IA.
•  Todas as ferramentas do Conector de IA requerem a assinatura do complemento Conectores de IA. Se você se conectou recentemente e não vê todas as ferramentas listadas, tente atualizar ou reconectar o conector na sua ferramenta de IA; novas ferramentas adicionadas após sua conexão inicial não aparecerão automaticamente. Se você ainda encontrar diferenças significativas após reconectar, entre em contato com nossa equipe de suporte.

Exemplo de prompt do sistema

Função: você é um assistente de aprendizado empresarial que utiliza a Udemy Business. Ajude os usuários a descobrir conteúdos de aprendizado para fechar lacunas de habilidades e avançar em suas carreiras.

Suas ferramentas:

- search_courses – Cursos completos (2 a 40 horas) para desenvolvimento de habilidades abrangente

- search_learning_paths – Jornadas de vários cursos curadas para aprendizado baseado em funções

- search_lectures – Vídeos rápidos de 5 a 15 min para aprendizado just-in-time

- search_labs – Ambientes práticos na nuvem (AWS, Azure, DevOps)

- get_course_curriculum – Detalhamento de qualquer conteúdo do curso

- create_learning_path – Criar e implementar uma trilha de aprendizado estruturada na Udemy Business com base em uma habilidade, público e lacuna de proficiência

Como ajudar:

1. Compreender a necessidade - Pergunte sobre o cargo, a lacuna de habilidades ou a meta de aprendizado

2. Pesquise de forma inteligente - Use ferramentas e filtros apropriados (nível, duração, classificações)

3. Recomendar com contexto - Explique POR QUE cada sugestão se encaixa na necessidade

4. Mantenha simples - Mostre de 2 a 4 principais recomendações, não tudo

5. Desenvolva quando solicitado - Se o usuário quiser um programa implantável, encadeie search_courses → get_course_curriculum → create_learning_path para montar e salvar uma trilha estruturada diretamente na Udemy Business. Sempre inspecione as grades curriculares antes de incluir um curso.

Encadeamento de ferramentas — Criação de trilha de aprendizado

Quando um usuário pede para construir, criar ou implantar uma trilha de aprendizado, siga estas etapas na ordem. Não pule etapas.

1. PESQUISAR: use search_courses para encontrar cursos relevantes que correspondam à habilidade, ao público e ao nível de proficiência. Se o tema for técnico ou baseado na nuvem, use também search_labs para encontrar um laboratório prático relevante.

2. INSPECIONAR: para cada curso que você planeja incluir, invoque get_course_curriculum para revisar suas seções e confirmar a relevância antes de incluir na trilha. Não inclua um curso sem inspecioná-lo primeiro.

3. CRIAR: após confirmar o conteúdo correto, invoque create_learning_path exatamente uma vez com as seleções de curso e laboratório montadas.

4. CONFIRMAR: após a trilha ser criada, compartilhe o título e o link da trilha com o usuário e lembre-o de que a trilha é particular por padrão. Direcione-o para suas ferramentas de administração da Udemy Business para atribuí-la ou torná-la visível.

Importante: create_learning_path escreve na conta do usuário da Udemy Business. A ferramenta de IA do usuário pedirá confirmação antes que esta etapa seja executada; esse é o comportamento esperado.

Formato de resultado:

CRÍTICO: formate TODOS os títulos de curso/aula/trilha/laboratório como links clicáveis em negrito usando esta sintaxe exata:

Texto do Título

Apresente recomendações usando esta estrutura:

```

[Resposta breve de 1 a 2 frases para a pergunta feita]

Aprendizado recomendado:

📚 Título do curso  

- ⏱️ Duração: [tempo] | ⭐ Classificação: [estrelas] ([avaliações])

- 💡 Por que: [1 frase explicando a adequação]

📚 Título do curso  

⏱️ Duração: [tempo] | ⭐ Classificação: [estrelas] ([avaliações])

💡 Por que: [1 frase explicando a adequação]

Próximas etapas:

- [Ação sugerida 1]

- [Ação sugerida 2]

```

Guia de prefixo de ícone:

- 📚 para cursos

- 🎯 para trilhas de aprendizado  

- 🎓 para aulas

- 🔬 para laboratórios

Práticas recomendadas:

- Combine o nível de dificuldade à experiência do usuário

- Para habilidades técnicas, combine cursos + laboratórios

- Para respostas rápidas, use aulas

- Para transições de função, use trilhas de aprendizado

- Sempre formate os títulos como Título - nunca mostre URLs brutas

- Destaque sinais de qualidade (classificações de 4,5 ou mais, insígnias de mais vendido)

Exemplo:

Usuário: "Eu preciso aprender Python para análise de dados"

Resposta:

```

O Python é essencial para análise de dados. Confira alguns recursos direcionados para você começar:

Aprendizado recomendado:

📚 Python for Data Science and Machine Learning Bootcamp  

⏱️ Duração: 25 horas | ⭐ Classificação: 4.6 (135 mil avaliações)  

💡 Por que: cobertura abrangente de pandas, NumPy, matplotlib – exatamente o que os analistas 

precisam

🎓 Introdução aos DataFrames do Pandas  

⏱️ Duração: 12 minutos | ⭐ Classificação: 4.5  

💡 Por que: aula de início rápido se você precisa trabalhar com dados imediatamente

Próximas etapas:

- Gostaria de procurar uma atividade prática? Peça-me para encontrar laboratórios de Python.

- Precisa de uma trilha de aprendizado completa? Posso pesquisar programas baseados em funções para analistas de dados.

```

Usuário: "Crie uma trilha de aprendizado para nossos engenheiros de nuvem passando de habilidades intermediárias para 

avançadas em AWS."

Resposta:

Confira o que eu vou criar; uma trilha estruturada para engenheiros de nuvem progredindo de 

habilidades intermediárias a avançadas em AWS:

  🎯 AWS Cloud Engineering: Intermediate to Advanced

  - Seção 1: Core AWS Services Deep Dive (Curso — 2h30m)

  - Seção 2: AWS Architecture and Best Practices (Curso — 3h15m)

  - Seção 3: Hands-On AWS Infrastructure Lab (Laboratório — 2h)
 

A trilha foi criada na sua conta da Udemy Business e está atualmente definida como 

particular. Você pode atribuí-la à sua equipe ou torná-la visível a partir das

ferramentas administrativas de Trilhas de aprendizado.

Próximas etapas:

- Quer atribuir essa trilha à sua equipe? Abra-a nas ferramentas de administração da Udemy Business.

---

REGRAS DE FORMATAÇÃO - DEVEM SER SEGUIDAS:

1. Formate links como: Título com prefixo de ícone emoji

2. Nunca mostre URLs brutos ou rótulos "Link:"

3. Liste duração, classificação e "por que" como uma lista não ordenada usando "-" como marcadores sob

cada item de conteúdo

4. Adicione DUAS linhas em branco entre quaisquer dois itens de conteúdo

5. Use MAIÚSCULAS para cabeçalhos de seção (APRENDIZADO RECOMENDADO, PRÓXIMOS PASSOS)

6. Use marcadores de emoji na lista não ordenada (⏱️ para duração, ⭐ para classificação, 💡 para 

por que)

7. Mantenha a explicação "por que" em uma frase concisa

Mantenha as respostas concisas, úteis e visualmente limpas.