> 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/agente-de-recrutamento.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, em seu nome, as solicitações recebidas. Ele se baseia na abordagem de recrutamento orientada por fluxo de trabalho. Para a alternativa baseada em regras, veja [Explicação dos Fluxos de Trabalho 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/agente-de-recrutamento/configurar-o-agente-de-recrutamento.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 cuida de uma parte específica do funil de recrutamento. Cada cartão de subagente tem um alternador. Defina-o como  **\[Ativar alternador]** para incluir o subagente no funil, ou  **\[Desativar alternador]** para pular essa parte do funil. Você configura cada subagente de forma independente.
O agente trabalha a partir de um único conjunto de instruções que você controla. Para saber como escrevê-las e refiná-las, veja [Escrever Instruções Eficazes para Agentes](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/agente-de-recrutamento/escrever-instrucoes-eficazes-para-o-agente.md).
Subagente Discover
O subagente Discover usa as Instruções que você fornece para encontrar, avaliar e organizar novos prospects no Marketplace do impact.com e adiciona as melhores correspondências à sua lista de Prospects.
Dispare o Discover manualmente selecionando **Executar Discover** no cartão do agente, ou defina-o para ser executado em um cronograma. Enquanto o subagente estiver ocupado, o texto do botão muda para *Em execução* e o botão fica desativado. Após a conclusão de uma execução, aguarde alguns minutos até o processamento terminar e, então, encontre os parceiros que ele adicionou na página Prospects definindo o filtro *Source* 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/agente-de-recrutamento/acompanhar-os-resultados-do-agente-de-recrutamento.md).
{% hint style="success" %}
**Observação:** No Beta, você pode executar o Discover uma vez a cada 24 horas. Uma execução agendada usa esse limite diário, então, se houver uma execução agendada, você não poderá executá-la manualmente no mesmo dia.
{% endhint %}
Se você receber uma mensagem de que **Executar Discover** está indisponível, uma dica informa que você já usou todas as execuções de Discover do período atual de 24 horas. Você poderá executar o Discover novamente no dia seguinte.
Se uma execução do Discover retornar poucas ou nenhuma correspondência, recomendamos tornar suas instruções menos restritivas. Edite-as e execute o Discover novamente.
Quando o Discover é executado, o subagente pesquisa o Marketplace, avalia os candidatos com base nas suas instruções e adiciona as melhores correspondências à sua lista de Prospects com *Source = Agente de Recrutamento*, no grupo que você definiu em Atribuir grupos.
Quando o subagente determina que um parceiro não é uma correspondência, ele o ignora nas execuções futuras por 6 meses ou até você atualizar suas instruções, o que ocorrer primeiro. Isso mantém o Discover eficiente, evitando reavaliar 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 Discover já vem pré-configurado. Você pode revisar e editar seus canais de sourcing, atribuição de grupo, agendamento e limite de execuções 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/agente-de-recrutamento/configurar-o-agente-de-recrutamento.md).
Subagente Avaliar Solicitações
O subagente Avaliar Solicitações avalia automaticamente as solicitações de parceiros recebidas usando as regras nas suas Instruções, com a opção de proteger correspondências incertas.
Quando o Quality & Safety Guardrails está ativado, apenas parceiros que atendem aos padrões de segurança do Marketplace da plataforma são avaliados pelo agente. Por padrão, as solicitações de parceiros que não atendem a esses padrões ficam pendentes para sua análise, o que você pode alterar com a configuração Padrão de fallback.
O subagente é executado em cada solicitação recebida, então você não o aciona manualmente. Ele toma decisões em segundos após o envio da solicitação.
Você define quanta autonomia o subagente tem:
* **Autopilot** (recomendado): o agente compara cada solicitação com suas instruções e com os dados do parceiro, depois aceita ou rejeita correspondências claras e deixa solicitações ambíguas para sua equipe analisar.
* **Copilot:** o agente recomenda uma ação atribuindo o parceiro a um grupo, e você toma a decisão final na [*Solicitações*](https://app.impact.com/secure/advertiser/engage/contracts/activity/adv-manage-pending-public-ios-v2-flow.ihtml) página. Veja [Analisar Solicitaçõ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 Copilot para validar suas Instruções e refiná-las até que as sugestões do agente correspondam consistentemente ao que você deseja.
As rejeições incluem um motivo de rejeição estruturado, para que elas fluam corretamente para seus relatórios existentes e para o token de e-mail `{rejectReason}` email.
**Altere uma decisão tomada pelo agente.** Se você precisar de um resultado diferente para uma solicitação que o agente aceitou ou rejeitou, selecione **Revisar Decisão** na linha correspondente na aba **Processadas** da página [**Solicitações**](https://app.impact.com/secure/advertiser/engage/contracts/activity/adv-manage-pending-public-ios-v2-flow.ihtml) . Você pode alterar uma decisão em até 6 meses após ela ser tomada.
O subagente Avaliar Solicitações já vem pré-configurado. Você pode revisar e editar seus controles 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. Este 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 adicionados pelo Discover usando um Fluxo de Trabalho de E-mail:
1. Configure um segmento de parceiros que direcione os prospects adicionados pelo Discover. Veja [Entrar em contato com 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 na Explicação de Fluxos de Trabalho de E-mail.
2. Crie um fluxo de trabalho de e-mail personalizado que use esse segmento e adicione seu e-mail de abordagem. Veja [Criar e Gerenciar Fluxos de Trabalho 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 do seu próprio endereço de e-mail em vez do endereço genérico do impact.com. Veja [Conectar 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 opção quando você configura o e-mail do fluxo de trabalho.
## **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 **Quality & Safety Guardrails** no subagente Avaliar Solicitações. Veja [Configurar o Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/agente-de-recrutamento/configurar-o-agente-de-recrutamento.md).
## Veja onde o agente se encaixa com sua automação existente
Se você já usa [Fluxos de Trabalho de Solicitaçã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 Solicitaçã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 Fluxos de Trabalho depende da sua edição. Fluxos de Trabalho de Solicitação estão disponíveis nas edições Essential, Pro e Enterprise, e Fluxos de Trabalho de E-mail estão disponíveis nas edições Pro e Enterprise. As edições Starter e Starter Agency não têm acesso aos Fluxos de Trabalho.
{% endhint %}
As solicitaçõ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. **Fluxos de Trabalho de Solicitação.** Sua automação baseada em regras.
4. **Agente de Recrutamento e seu Webhook de Solicitação.** O agente avalia as solicitações que as etapas anteriores deixaram pendentes. Ao mesmo tempo, seu Webhook de Solicitação envia a solicitação para o endpoint que você configura em [postbacks de notificação de evento](/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 uma decisão por conta própria. Você pode enviar as decisões de volta usando a API de Processamento de Solicitações.
O Agente de Recrutamento nunca substitui uma decisão já tomada pelas etapas acima. Se um revisor manual agir sobre uma solicitação antes de o agente terminar, a decisão manual tem prioridade.
{% hint style="success" %}
**Observação:** Como o Agente de Recrutamento e seu Webhook de Solicitação são executados ao mesmo tempo, seu Webhook pode enviar a solicitação antes de o agente terminar de avaliá-la. Para fazer com que o agente decida primeiro, adicione um atraso ao seu Webhook na configuração de Webhook na página Configurações. O seu Webhook então enviará a solicitação após o atraso, carregando 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 Fluxos de Trabalho de Solicitação. Os Fluxos de Trabalho são mais rápidos e não consomem capacidade do agente para decisões que não exigem raciocínio.
Para saber mais sobre a ordem dos fluxos de trabalho, veja [Definir a Ordem de Execução dos Fluxos de Trabalho de Solicitaçã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 tipos de programa **Performance**, **Creator**, e **Amazon Seller** programas.
O subagente Convidar Prospects não está disponível nesta versão. Ele está planejado para a v2 nas edições Essential, Pro e Enterprise. O painel de resultados também estará disponível 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/agente-de-recrutamento/acompanhar-os-resultados-do-agente-de-recrutamento.md) como encontrar seus resultados.
## **Gerenciar seus agentes**
A *Agentes* página lista todos os agentes que você ativou. Para abri-la, selecione **Agentes** no menu de navegação à esquerda. No Beta, você pode configurar 1 agente de recrutamento. O suporte para vários agentes estará disponível em breve.
Na *Agentes* página, seu agente aparece como um cartão mostrando seu status, última atualização e ações rápidas.
No cartão do agente, você pode:
* Selecione **Visualizar** para abrir o agente e ajustar suas configurações.
* Selecione **Executar Discover** para iniciar uma execução do Discover.
* Selecione  **\[Mais]** para mais ações:
* **Pausar:** interromper execuções agendadas do Discover e a avaliação de solicitações recebidas. Prospects e solicitações existentes não são afetados.
* **Excluir:** remover o agente.
Para encontrar os resultados do seu agente. Veja [Acompanhar Resultados do Agente de Recrutamento](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/agente-de-recrutamento/acompanhar-os-resultados-do-agente-de-recrutamento.md).
### **Atualize as configurações do seu agente**
Quando você abre um agente ativo, 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 *Configuração do Agente* . Veja [Escrever Instruções Eficazes para Agentes](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/agente-de-recrutamento/escrever-instrucoes-eficazes-para-o-agente.md).
* Selecione  **\[Ativar alternador]** ou  **\[Desativar alternador]** 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/agente-de-recrutamento/configurar-o-agente-de-recrutamento.md) para saber 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 do Discover e futuras avaliações de solicitações. O agente não reabre decisões passadas.
## **Siga as melhores práticas**
* Teste antes de confirmar. Valide suas Instruções com uma pequena execução do Discover e inicie o subagente Avaliar Solicitações no modo Copilot antes de ampliar a escala ou mudar para o Autopilot. Veja [Escrever Instruções Eficazes para Agentes](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/agente-de-recrutamento/escrever-instrucoes-eficazes-para-o-agente.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 entrar no seu programa.
* Na *Solicitações* tela, filtre por **Processado Por = Agente de Recrutamento** para ver todas as solicitações decididas pelo agente.
* Entre em contato com parceiros recém-adicionados e ativos em cliques usando [Fluxos de Trabalho 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 ao entrarem 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, em seguida, 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/agente-de-recrutamento.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.