Ligar um assistente de IA ao Orbit
Atualizado
mcp, assistente de ia, claude, chatgpt, conector, iniciar sessão a partir de um assistente, assistentes ligados, desligarEste artigo é para recrutadores que querem que um assistente de IA trabalhe as suas vagas no Orbit: ler os candidatos ordenados de uma vaga, criar rascunhos de vagas e calibrá-las, e registar pré-seleções e rejeições. O assistente liga-se ao servidor MCP do Orbit, https://api.wipperoz.com/v1/mcp, com início de sessão no Orbit ou com uma chave de API. Estes passos são para o início de sessão, que é como o ChatGPT se liga e uma das formas de o Claude se ligar.
Adicione o Orbit ao seu assistente
No ChatGPT ou no Claude, adicione um conector personalizado com o endereço https://api.wipperoz.com/v1/mcp e ligue-o. O seu assistente abre o Orbit.
Inicie sessão no Orbit
Inicie sessão com a sua conta do Orbit. Ligar um assistente indica o nome do assistente e o sítio para onde volta a seguir.
Escolha a conta
Se pertencer a mais do que uma conta do Orbit, escolha em Conta aquela para a qual o assistente trabalha.
Escolha o que pode fazer
Em O que pode fazer, marque o que o assistente pode fazer:
- ler vagas: ver as suas vagas, a calibração, a pré-visualização do pool e o que o Orbit fez em cada uma.
- rascunhos de vagas: criar rascunhos de vagas e calibrá-las. Nunca publica nem encerra uma vaga.
- ler candidatos: ler os candidatos ordenados das suas vagas tal como o Orbit os mostra, sem dados de contacto. Só um administrador pode permitir isto.
- registar decisões: registar as suas pré-seleções, rejeições e mudanças de etapa. Nunca envia e-mails a um candidato.
Aceite a adenda, se lhe for pedido
Se marcou ler candidatos, leia a Adenda do assistente de IA e marque Aceito a adenda do assistente de IA para esta conta.
Permita o acesso
Selecione Permitir. O Orbit volta a abrir o seu assistente, que já pode usar o que permitiu.
Aparece que só um administrador pode permitir que um assistente leia candidatos
Desmarque ler candidatos e selecione Permitir de novo, ou peça a um administrador da conta que ligue o assistente.
Aparece Este pedido expirou
Um pedido de ligação dura 10 minutos. Comece de novo a ligação a partir do seu assistente.
Aparece Iniciou sessão com o Virtual CV
Os assistentes ligam-se a contas do Orbit. Inicie sessão com a sua conta do Orbit e comece de novo a partir do seu assistente.
Ligar com uma chave de API
O Claude Code, o Codex, o Cursor e o VS Code enviam uma chave de API em vez de iniciarem sessão. Nas aplicações do Claude, um conector personalizado também pode levar uma chave num cabeçalho do pedido, se a sua organização do Claude tiver essa opção. É um proprietário da organização que a define.
- Crie uma chave com Assistente de IA ou Assistente de IA, só leitura. Consulte Criar uma chave de API para a API do Orbit.
- Adicione
https://api.wipperoz.com/v1/mcpao seu assistente, com o cabeçalhoAuthorizationdefinido comoBearerseguido da chave. A documentação do servidor MCP mostra como fazer em cada assistente.
Crie uma chave por assistente, para poder revogar uma sem mexer nas outras.
O que um assistente pode e não pode fazer
Pode:
- listar as suas vagas, com a indicação de cada anúncio ser gerido ou não e o estado do agente da vaga;
- criar o rascunho de uma vaga a partir de uma descrição, e calibrá-la;
- mostrar quantas pessoas do pool encaixam numa vaga;
- ler os candidatos de uma vaga gerida segundo o seu critério, com a adequação, a avaliação com IA, a triagem e o que está verificado, tal como o Orbit os mostra;
- pré-selecionar uma pessoa, rejeitá-la com um motivo ou passá-la para uma etapa;
- ler O que o Orbit fez da vaga.
Nunca publica, encerra nem gere uma vaga, não ativa o agente da vaga, não inicia uma triagem nem gasta nada. Nunca contacta um candidato, nunca vê endereços de e-mail, números de telefone nem as notas da sua equipa, e só trabalha na conta a que está ligado. Só lê candidatos de anúncios geridos.
Quando um assistente rejeita alguém
Uma decisão registada por um assistente não envia e-mails a ninguém. Se o Orbit costumasse enviar um e-mail com essa rejeição, a página do candidato mostra Não notificado. A pessoa não é informada, e a página Candidaturas dela não mostra a rejeição, até selecionar Enviar o e-mail de rejeição.
A adenda do assistente de IA
Uma chave ou ligação que lê candidatos envia dados de candidatos ao assistente e ao fornecedor de IA por trás dele, que a sua conta escolhe. Por isso, um administrador tem de aceitar primeiro a adenda do assistente de IA. O Orbit regista quem a aceitou, quando e que versão.
Ver ou desligar um assistente
Selecione Configurações na barra lateral e depois Chaves de API. Assistentes ligados lista cada assistente ligado com início de sessão, com o que pode fazer, quem o ligou, quando, e quando foi usado pela última vez. Para desligar um, selecione Revogar e depois Desligar agora: o pedido seguinte desse assistente é recusado. Um administrador pode desligar qualquer assistente, e um membro pode desligar os que ligou.
Um assistente que passe 30 dias sem usar o Orbit tem de se ligar de novo. Para parar um assistente que usa uma chave, revogue a chave na mesma página.