> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md).
# Agente de recrutamento
O Agente de Recrutamento automatiza o recrutamento de parceiros para o seu programa, usando IA para encontrar novos prospects no [Marketplace](/brand/pt-br/what-would-you-like-to-learn-about/performance-program/recruiting-partners/marketplace-vs-direct-partner-recruiting-explained.md) e avaliar inscrições recebidas em seu nome. Ele se baseia na abordagem de recrutamento baseada em workflows. Para a alternativa baseada em regras, veja [Explicação sobre Workflows de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/recruitment-workflows-explained.md). Para começar, veja [Configurar o Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).
{% hint style="warning" %}
**Beta:** O Agente de Recrutamento está atualmente em Beta e está disponível para um número limitado de marcas.
{% endhint %}
## Entenda como o agente funciona
O agente coordena 3 subagentes, e cada um lida com uma parte específica do funil de recrutamento. Cada cartão de subagente tem um botão de alternância. Defina-o como  **\[Ativar]** para incluir o subagente no funil, ou .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Desativar]** para pular essa parte do funil. Você configura cada subagente individualmente.
O agente funciona a partir de um único conjunto de instruções que você controla. Para saber como escrevê-las e refiná-las, veja [Escreva Instruções Eficazes para o Agente](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
Subagente Descoberta
O subagente Descoberta usa as Instruções que você fornece para encontrar, avaliar e organizar novos prospects no Marketplace da impact.com e adiciona as melhores correspondências à sua lista de Prospects.
Inicie a Descoberta manualmente selecionando **Executar Descoberta** no cartão do agente, ou configure-o para ser executado em um agendamento. Enquanto o subagente estiver ocupado, o texto do botão muda para *Em execução* e o botão fica desativado. Após a execução ser concluída, aguarde alguns minutos para que o processamento termine e então encontre os parceiros que ele adicionou na página de Prospects definindo o *Origem* filtro para *Agente de Recrutamento*. Veja [Acompanhar Resultados do Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md).
{% hint style="success" %}
**Observação:** Na versão Beta, você pode executar a Descoberta uma vez a cada 24 horas. Uma execução agendada usa esse limite diário, então, se houver uma execução agendada, você também não poderá executá-la manualmente nesse dia.
{% endhint %}
Se você receber uma mensagem informando que **Executar Descoberta** não está disponível, uma dica informa que você usou todas as execuções de Descoberta para o período atual de 24 horas. Você pode executar a Descoberta novamente no dia seguinte.
Se uma execução da Descoberta retornar pouquíssimas ou nenhuma correspondência, sugerimos flexibilizar suas instruções. Edite-as e execute a Descoberta novamente.
Quando a Descoberta é executada, o subagente pesquisa o Marketplace, avalia os candidatos de acordo com suas instruções e adiciona as melhores correspondências à sua lista de Prospects com *Origem = Agente de Recrutamento*, no grupo que você definir em Atribuir grupos.
Quando o subagente determina que um parceiro não é uma correspondência, ele o ignora em execuções futuras por 6 meses ou até que você atualize suas instruções, o que ocorrer primeiro. Isso mantém a Descoberta eficiente ao evitar a reavaliação de parceiros que você já descartou. Como uma mudança nas suas instruções significa que seus critérios de correspondência mudaram, toda a lista de ignorados é redefinida automaticamente.
O subagente Descoberta já vem pré-configurado. Você pode revisar e editar seus canais de sourcing, atribuição de grupo, agendamento e limite de execução antes de ativar o agente. Veja [Configurar o Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).
Subagente Avaliar Inscrições
O subagente Avaliar Inscrições avalia automaticamente as inscrições de parceiros recebidas usando as regras das suas Instruções, com a opção de proteger correspondências incertas.
Quando as Barreiras de Qualidade e Segurança estão ativadas, apenas parceiros que atendem aos padrões de segurança do Marketplace da plataforma são avaliados pelo agente. Por padrão, inscrições de parceiros que não atendem a esses padrões ficam pendentes para sua revisão, o que você pode alterar com a configuração de fallback padrão.
O subagente é executado em cada inscrição recebida, então você não o inicia manualmente. Ele toma decisões em segundos após a inscrição ser enviada.
Você define quanta autonomia o subagente tem:
* **Piloto automático** (recomendado): o agente compara cada inscrição com suas instruções e os dados do parceiro, depois aceita ou rejeita correspondências claras e deixa inscrições ambíguas para sua equipe revisar.
* **Copiloto:** o agente recomenda uma ação atribuindo o parceiro a um grupo, e você toma a decisão final na [*Inscrições*](https://app.impact.com/secure/advertiser/engage/contracts/activity/adv-manage-pending-public-ios-v2-flow.ihtml) página. Veja [Revisar Inscrições de Parceiros e Criadores](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/review-partner-and-creator-applications.md).
Se você está começando, use o modo Copiloto para validar suas Instruções e refiná-las até que as sugestões do agente correspondam consistentemente ao que você quer.
As rejeições incluem um motivo estruturado de rejeição, para que fluam corretamente para seus relatórios existentes e o `{rejectReason}` token de e-mail.
**Altere uma decisão tomada pelo agente.** Se você precisar de um resultado diferente para uma inscrição que o agente aceitou ou rejeitou, selecione **Revisar decisão** na linha dela na **Processadas** aba de [**Inscrições**](https://app.impact.com/secure/advertiser/engage/contracts/activity/adv-manage-pending-public-ios-v2-flow.ihtml) página. Você pode alterar uma decisão dentro de 6 meses após ela ser tomada. Corrigir uma rejeição aceita o parceiro imediatamente, sem necessidade de novo convite e sem esperar que ele responda, então uma decisão errada não lhe custa nenhuma oportunidade. Veja [Altere sua decisão em uma inscrição processada](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/process-partners-in-bulk-and-reverse-rejections.md#change-your-decision-on-a-processed-application) para ambos os fluxos.
O subagente Avaliar Inscrições já vem pré-configurado. Você pode revisar e editar suas barreiras de segurança, autonomia e atribuição de grupo antes de ativar o agente. Veja [Configurar e ativar o agente](#set-up-and-activate-the-agent).
Convidar Prospects (Em breve)
O subagente Convidar Prospects permitirá que o agente envie convites automaticamente para os prospects descobertos. Esse subagente fica visível na configuração do agente, mas não está disponível nesta versão.
Até que ele esteja disponível, você pode enviar e-mails para os prospects que a Descoberta adiciona usando um Workflow de E-mail:
1. Configure um segmento de parceiros que direcione aos prospects adicionados pela Descoberta. Veja [Entre em contato com os prospects adicionados pelo Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/email-workflows/partner-segments-for-email-workflows-explained.md#reach-out-to-prospects-added-by-the-recruitment-agent) em Segmentos de Parceiros em Explicação sobre Workflows de E-mail.
2. Crie um workflow de e-mail personalizado que use esse segmento e adicione seu e-mail de contato. Veja [Criar e Gerenciar Workflows de E-mail](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/email-workflows/create-and-manage-email-workflows.md).
3. Opcionalmente, envie usando seu próprio endereço de e-mail em vez do endereço genérico da impact.com. Veja [Conecte seu e-mail pessoal à sua conta impact.com](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/emails/connect-your-personal-email-to-your-impactcom-account.md). Depois de conectado, seu endereço aparece como uma opção quando você configura o e-mail do workflow.
## **Proteja sua marca**
O Agente de Recrutamento não adicionará os seguintes parceiros ao seu programa:
* Parceiros na sua [lista de bloqueio](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-management/block-partners-from-re-applying-to-your-program.md).
* Parceiros sinalizados por comportamento fraudulento.
Você pode adicionar outra camada de proteção ativando **Barreiras de Qualidade e Segurança** no subagente Avaliar Inscrições. Veja [Configurar o Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).
## Veja onde o agente se encaixa na sua automação existente
Se você já usa [Workflows de Inscrição](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/create-workflows-to-automatically-process-partner-applications.md), Impact AI ou um Webhook de Inscrição, o Agente de Recrutamento se encaixa em uma ordem definida para que sua automação existente continue funcionando como esperado.
{% hint style="info" %}
O acesso aos Workflows depende da sua edição. Application Workflows está disponível nas edições Essential, Pro e Enterprise, e Email Workflows está disponível nas edições Pro e Enterprise. As edições Starter e Starter Agency não têm acesso aos Workflows.
{% endhint %}
As inscrições são avaliadas nesta ordem:
1. **Verificações de segurança da plataforma.** As verificações básicas de segurança são executadas primeiro.
2. **Impact AI.**
3. **Workflows de Inscrição.** Sua automação baseada em regras.
4. **O Agente de Recrutamento e seu Webhook de Inscrição.** O agente avalia as inscrições que as etapas anteriores deixaram pendentes. Ao mesmo tempo, seu Webhook de Inscrição envia a inscrição para o endpoint que você configurar em [postbacks de notificação de eventos](/brand/pt-br/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md). O Webhook não toma a decisão por conta própria. Você pode retornar as decisões usando a API de Processamento de Inscrições.
O Agente de Recrutamento nunca substitui uma decisão já tomada pelas etapas acima. Se um revisor humano agir sobre uma inscrição antes de o agente concluir, a decisão manual tem precedência.
{% hint style="success" %}
**Observação:** Como o Agente de Recrutamento e seu Webhook de Inscrição são executados ao mesmo tempo, seu Webhook pode enviar a inscrição antes de o agente terminar de avaliá-la. Para que o agente decida primeiro, adicione um atraso ao seu Webhook na configuração do Webhook na página Configurações. O seu Webhook então envia a inscrição após o atraso, trazendo a decisão do agente.
{% endhint %}
Se suas Instruções incluírem regras rígidas e determinísticas, como "não aceitar parceiros fora dos EUA", considere adicioná-las também como Workflows de Inscrição. Workflows são mais rápidos e não consomem capacidade do agente para decisões que não exigem raciocínio.
Para mais informações sobre a ordem dos workflows, veja [Definir a ordem de execução do Workflow de Inscrição](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/set-application-workflow-execution-order.md).
## **Verifique o acesso da sua edição**
O Agente de Recrutamento está disponível para **Performance**, **Creator**, e **Amazon Seller** tipos de programa.
O subagente Convidar Prospects não está disponível nesta versão. Ele está previsto para a v2 nas edições Essential, Pro e Enterprise. O painel de resultados também está chegando em breve; até lá, veja [Acompanhar Resultados do Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md) como encontrar seus resultados.
## **Gerencie seus agentes**
A *Agentes* página lista todos os agentes que você ativou. Para abri-la, selecione **Agentes** no menu de navegação à esquerda. Na versão Beta, você pode configurar 1 agente de recrutamento. O suporte para vários agentes chegará em breve.
Na *Agentes* página, seu agente aparece como um cartão mostrando o status, a última atualização e ações rápidas.
No cartão do agente, você pode:
* Selecionar **Ver** para abrir o agente e ajustar suas configurações.
* Selecionar **Executar Descoberta** para iniciar uma execução da Descoberta.
* Selecionar  **\[Mais]** para mais ações:
* **Pausar:** interromper execuções agendadas da Descoberta e a avaliação de inscrições recebidas. Os prospects e inscrições existentes não são afetados.
* **Excluir:** remover o agente.
Para encontrar os resultados dos seus agentes. Veja [Acompanhar Resultados do Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md).
### **Atualize as configurações do seu agente**
Ao abrir um agente ativo, você pode ajustar a configuração dele a qualquer momento.
* Para renomear o agente, selecione  **\[Editar]** ao lado do nome do agente no topo da página.
* Para editar suas instruções, selecione **Editar** no *painel de Configuração do Agente* . Veja [Escreva Instruções Eficazes para o Agente](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
* Selecionar  **\[Ativar]** ou .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Desativar]** no cartão de um subagente para incluí-lo no funil ou pausá-lo. Para alterar as configurações de um subagente, selecione **Editar** no cartão dele. Veja [Configurar o Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md) o que cada configuração faz.
Depois de salvar suas alterações no nível do subagente, selecione **Atualizar** no canto superior direito para aplicá-las.
As alterações se aplicam a futuras execuções da Descoberta e futuras avaliações de inscrições. O agente não reabre decisões passadas.
## **Siga as melhores práticas**
* Teste antes de implementar. Valide suas Instruções com uma pequena execução da Descoberta e inicie o subagente Avaliar Inscrições no modo Copiloto antes de ampliar a escala ou mudar para o Piloto automático. Veja [Escreva Instruções Eficazes para o Agente](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
* Revise os parceiros quando eles se tornarem ativos em cliques. Você pode fazer isso de 2 maneiras:
* No [*Relatório de Produtividade do Parceiro*](/brand/pt-br/what-would-you-like-to-learn-about/performance-program/performance-program-reports/partner-productivity-report-for-brands.md), consulte *Nome do Parceiro* e *Data do Primeiro Clique* para ver quando um parceiro gerou um clique pela primeira vez após ingressar no seu programa.
* Na *Inscrições* tela, filtre por **Processado por = Agente de Recrutamento** para ver todas as inscrições sobre as quais o agente tomou decisão.
* Entre em contato com parceiros ativos em cliques recém-adicionados usando [Workflows de E-mail](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/email-workflows.md) para apoiar os próximos passos deles à medida que ingressam no seu programa.
* [Expirar contratos](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/contracts/expire-partner-contracts.md) para parceiros que não sejam uma boa opção e, depois, atualize suas Instruções para reduzir erros semelhantes em avaliações futuras.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.