> 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 potenciais parceiros 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 as inscrições recebidas em seu nome. Ele se baseia na abordagem de recrutamento baseada em 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/recruitment-agent/set-up-the-recruitment-agent.md).
{% hint style="warning" %}
**Beta:** O Agente de Recrutamento está em Beta e está disponível para um número limitado de marcas com programas Performance, Creator ou Amazon Seller.
{% 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 uma chave. Defina-a 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 de forma independente.
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 de descoberta
O subagente de Descoberta usa as instruções que você fornece para encontrar, avaliar e organizar novos potenciais parceiros no Marketplace da impact.com, e adiciona os melhores correspondentes à sua lista de Potenciais parceiros.
Acione a Descoberta manualmente selecionando **Executar Descoberta** no cartão do agente, ou configure-o para ser executado em um agendamento. Enquanto o subagente estiver em execução, 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 para terminar o processamento e, em seguida, encontre os parceiros adicionados na página de *Potenciais parceiros* definindo o filtro *Origem* como *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:** No Beta, você pode executar a Descoberta até 5 vezes em um período de 24 horas, incluindo execuções agendadas.
{% endhint %}
Se você receber uma mensagem de que **Executar Descoberta** está indisponível, uma dica informa que você usou todas as suas execuções de Descoberta no período atual de 24 horas. Você poderá executar a Descoberta novamente quando esse período terminar.
Se uma execução da Descoberta retornar muito poucos ou nenhum resultado correspondente, flexibilize 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 os melhores correspondentes à sua *Potenciais parceiros* lista com *Origem = Agente de Recrutamento*, no grupo que você definiu em Atribuir grupos. Para cada potencial parceiro que ele adiciona, o agente deixa uma nota no log de Atividades do parceiro explicando por que esse potencial parceiro é uma boa opção. Veja [Ver parceiros em potencial](/brand/pt-br/what-would-you-like-to-learn-about/performance-program/recruiting-partners/prospective-partners/view-prospective-partners.md#view-the-partners-basic-information).
Quando o subagente determina que um parceiro não é compatível, 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, evitando reavaliar parceiros que você já descartou. Como uma alteração em suas instruções significa que seus critérios de correspondência mudaram, toda a lista de ignorados é redefinida automaticamente.
O subagente de Descoberta já vem pré-configurado. Você pode revisar e editar seus canais de obtenção, 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 de Avaliação de Inscrições
O subagente de Avaliação de 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 *Diretrizes de Qualidade e Segurança* está ativado, 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 são rejeitadas, o que você pode alterar com a configuração *Alternativa se as Diretrizes de Qualidade e Segurança falharem* O agente aplica essa alternativa imediatamente, tanto no Autopilot quanto no Copilot. O cartão de Avaliação de Inscrições mostra *Obrigatório* quando *Diretrizes de Qualidade e Segurança* está ativado, e *Não obrigatório* quando está desativado.
O subagente é executado em todas as inscrições recebidas, então você não o aciona manualmente. Ele toma decisões em poucos segundos após o envio da inscrição.
Você define quanta autonomia o subagente tem:
* **Autopilot** (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.
* **Copilot:** o agente recomenda aceitar ou rejeitar cada inscrição atribuindo-a a um grupo, e você toma a decisão final na página de [*Inscrições*](https://app.impact.com/secure/advertiser/engage/contracts/activity/adv-manage-pending-public-ios-v2-flow.ihtml) Se você não agir em até 7 dias, o agente aplicará a recomendação para você. 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ê estiver começando, use o modo Copilot para validar suas instruções e refiná-las até que as recomendações do agente correspondam consistentemente ao que você deseja.
As rejeições incluem um motivo estruturado de rejeição, para que fluam corretamente para seus relatórios existentes e para o token de e-mail `{rejectReason}` .
**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 correspondente na aba **Processadas** da [**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 em até 6 meses após ela ter sido tomada. Corrigir uma rejeição aceita o parceiro imediatamente, sem necessidade de novo convite e sem esperar uma resposta dele, então uma decisão errada não custa nenhuma oportunidade. Veja [Altere sua decisão sobre 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 de Avaliação de Inscrições já vem pré-configurado. Você pode revisar e editar suas diretrizes de segurança, autonomia e atribuição de grupo antes de ativar o agente. Veja [Configure e ative o agente](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md#set-up-and-activate-the-agent).
Convidar potenciais parceiros (em breve)
O subagente Convidar Potenciais Parceiros aparece na configuração do agente com um rótulo Em breve. Para enviar e-mail aos potenciais parceiros que a Descoberta adiciona, use um Fluxo de Trabalho de E-mail:
1. Configure um segmento de parceiros que tenha como alvo os potenciais parceiros adicionados pela Descoberta. Veja [Entre em contato com potenciais parceiros 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 para a 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 a partir do 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 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 **Diretrizes de Qualidade e Segurança** no subagente de Avaliação de 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 [Fluxos de Trabalho de Inscrições](/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ções, o Agente de Recrutamento se encaixa em uma ordem definida para que sua automação existente continue funcionando como esperado.
{% hint style="success" %}
**Observação:** O acesso aos Fluxos de Trabalho depende da sua edição. Fluxos de Trabalho de Inscrições está disponível nas edições Essential, Pro e Enterprise, e Fluxos de Trabalho de E-mail está disponível nas edições Pro e Enterprise. As edições Starter e Starter Agency não têm acesso aos Fluxos de Trabalho.
{% 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. **Fluxos de Trabalho de Inscrições.** Sua automação baseada em regras.
4. **Agente de Recrutamento e seu Webhook de Inscrições.** O agente avalia as inscrições que as etapas anteriores deixaram pendentes. Ao mesmo tempo, seu Webhook de Inscrições envia a inscrição para o endpoint que você configura 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#notification-events-and-payloads). O Webhook não toma uma decisão por conta própria. Você pode publicar as decisões de volta 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 terminar, a decisão manual tem precedência.
{% hint style="success" %}
**Observação:** Como o Agente de Recrutamento e seu Webhook de Inscrições 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 de Webhook da página de Configurações. Assim, seu Webhook enviará a inscrição após o atraso, levando 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 Inscrições. 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 do Fluxo de Trabalho de Inscrições](/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).
## Gerencie seus agentes
A *Agentes* página lista todos os agentes que você ativou. No Beta, você pode configurar 1 agente de recrutamento.
1. No menu de navegação à esquerda, selecione  [**Agentes**](https://app.impact.com/secure/advertiser/agents/fr/agent-marketplace.ihtml).
* Seu agente aparece como um cartão mostrando o status, a última atualização e ações rápidas.
2. No cartão do seu agente, escolha uma ação:
* Selecione **Ver** para abrir o agente e ajustar suas configurações.
* Selecione **Executar Descoberta** para iniciar uma execução da Descoberta.
* Selecione  **\[Mais]** para mais ações:
* **Ver potenciais parceiros encontrados:** abra a *Potenciais parceiros* página, filtrada para os potenciais parceiros adicionados pelo subagente de Descoberta.
* **Ver inscrições avaliadas:** abra a *Inscrições* página, filtrada para as inscrições avaliadas pelo agente. 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).
* **Pausar:** interrompa as execuções agendadas da Descoberta e a avaliação de inscrições recebidas. Os potenciais parceiros e inscrições existentes não são afetados.
* **Excluir:** remova 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/recruitment-agent/track-recruitment-agent-results.md).
### Atualize as configurações do seu agente
Ao abrir um agente ativo, você pode ajustar sua configuração 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 *Instruções 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).
* Selecione  **\[Ativar]** ou .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Desativar]** na carta de um subagente para incluí-lo ou pausá-lo no funil. Para alterar as configurações de um subagente, selecione **Editar** em seu cartão. 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) 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 às futuras execuções da Descoberta e às futuras avaliações de inscriçõ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 da Descoberta e inicie o subagente de Avaliação de Inscrições no modo Copilot antes de escalar ou mudar para o Autopilot. 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 clique. Você pode fazer isso de 2 maneiras:
* No [*Relatório de Produtividade de Parceiros*](/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 seu primeiro clique após entrar no seu programa.
* Na *Inscrições* tela **Filtrado por = Agente de Recrutamento** para ver todas as inscrições decididas pelo agente.
* Entre em contato com parceiros recém-adicionados e ativos em clique 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 as próximas etapas 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) de 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 by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.