> 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 seu programa, usando IA para buscar novos prospects no [Marketplace](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/performance-program/recruiting-partners/marketplace-vs-direct-partner-recruiting-explained.md) e avaliar as candidaturas recebidas em seu nome. Ele se baseia na abordagem de recrutamento baseada em fluxos de trabalho. Para conhecer a alternativa baseada em regras, consulte [Entenda os fluxos de trabalho de recrutamento](https://help.impact.com/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, consulte [Configurar o Agente de Recrutamento](https://help.impact.com/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 aberto e disponível para marcas com programas de Performance, Creator ou Amazon Seller.
{% endhint %}

## Entenda como o agente funciona

O agente coordena 3 subagentes, cada um responsável por uma parte específica do funil de recrutamento. O cartão de cada subagente tem um botão. Defina-o como ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Botão ativado]** para incluir o subagente no funil ou como ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FACIoqj1Ayhx8QzL9aqYB%2Ftoggle-off-solid%20\(1\).svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) **\[Botão desativado]** para pular essa parte do funil. Você configura cada subagente de forma independente. Consulte as seções sobre os subagentes abaixo.

O agente funciona com um único conjunto de instruções que você controla. Para saber como escrevê-las e refiná-las, consulte [Escrever instruções eficazes para o agente](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).

<details>

<summary>Subagente Discover</summary>

O subagente Discover usa as instruções fornecidas para buscar, avaliar e organizar novos prospects no Marketplace da impact.com e adicionar os mais compatíveis à sua lista de Prospects.

Inicie o Discovery manualmente selecionando **Run Discover** no cartão do agente ou configure uma programação para executá-lo. Enquanto o subagente estiver ocupado, o texto do botão muda para *Running* e o botão fica desativado. Quando a execução terminar, aguarde alguns minutos para que o processamento seja concluído e encontre os parceiros adicionados na página *Prospects* definindo o filtro *Source* como *Recruitment Agent*. Consulte [Acompanhar os resultados do Agente de Recrutamento](https://help.impact.com/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:** Durante o Beta, você pode executar o Discovery até 5 vezes em um período de 24 horas, incluindo as execuções programadas.
{% endhint %}

Se aparecer uma mensagem informando que **Run Discover** está indisponível, uma dica de ferramenta informa que você usou todas as execuções do Discovery disponíveis no período atual de 24 horas. Você poderá executar o Discovery novamente quando esse período terminar.

Se uma execução do Discovery retornar poucos ou nenhum resultado compatível, flexibilize suas instruções. Edite-as e execute o Discovery novamente.

Quando o Discovery é executado, o subagente pesquisa no Marketplace, avalia os candidatos de acordo com suas instruções e adiciona os mais compatíveis à sua lista de *Prospects* com *Source = Recruitment Agent*, no grupo definido em Assign groups. Para cada prospect adicionado, o agente deixa uma observação no registro de atividades do parceiro explicando por que ele é compatível. Consulte [Ver parceiros em potencial](https://help.impact.com/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 nas próximas execuções por 6 meses ou até que você atualize suas instruções, o que ocorrer primeiro. Isso mantém o Discovery eficiente, evitando reavaliar parceiros que você já descartou. Como uma alteração nas instruções significa que seus critérios de compatibilidade mudaram, a lista de parceiros ignorados é redefinida automaticamente por completo.

O subagente Discover já vem pré-configurado. Você pode revisar e editar os canais de busca, a atribuição de grupo, a programação e o limite de execuções antes de ativar o agente. Consulte [Configurar o Agente de Recrutamento](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).

</details>

<details>

<summary>Subagente Evaluate Applications</summary>

O subagente Evaluate Applications avalia automaticamente as candidaturas recebidas de parceiros usando as regras das suas instruções, com a opção de proteger contra decisões sobre correspondências incertas.

Quando *Proteções de qualidade e segurança* está ativado, o agente avalia apenas os parceiros que atendem aos padrões de segurança do Marketplace da plataforma. Por padrão, as candidaturas de parceiros que não atendem a esses padrões são rejeitadas, mas você pode alterar essa configuração com o *Alternativa caso as proteções de qualidade e segurança falhem* configuração. O agente aplica essa alternativa imediatamente, tanto no Autopilot quanto no Copilot, e atribui a inscrição a um grupo que indica por que ela foi rejeitada ou deixada pendente. O cartão Avaliar inscrições mostra *Obrigatório* quando *Proteções de qualidade e segurança* está ativado, e *Não obrigatório* quando está desativado. Consulte [Configurações de Avaliar inscrições](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md#evaluate-applications-settings).

O subagente é executado para cada inscrição recebida, então você não precisa acioná-lo manualmente. Ele toma decisões em segundos após o envio da inscrição.

Você define o nível de autonomia do subagente:

* **Autopilot** (recomendado): o agente compara cada inscrição com suas instruções e os dados do parceiro, depois aceita ou rejeita as correspondências claras e deixa as inscrições ambíguas para sua equipe analisar.
* **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 [*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 aplica a recomendação por você. Consulte [Analisar inscrições de parceiros e criadores](https://help.impact.com/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 aprimorá-las até que as recomendações do agente correspondam consistentemente ao que você deseja.

Sempre que o agente aceita, rejeita ou recomenda uma decisão sobre uma inscrição, ele deixa uma nota no registro de atividades da inscrição explicando o motivo. Consulte [Acompanhar os resultados do agente de recrutamento](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md#see-the-applications-the-agent-evaluated).

As rejeições incluem um motivo de rejeição estruturado, para que sejam registradas corretamente nos seus relatórios existentes e no token de e-mail `{rejectReason}` .

**Alterar uma decisão tomada pelo agente.** Se precisar de um resultado diferente para uma inscrição que o agente aceitou ou rejeitou, selecione **Revisar decisão** na linha correspondente da aba **Processadas** da página [**Inscriçõ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. Corrigir uma rejeição aceita o parceiro imediatamente, sem necessidade de um novo convite nem de esperar que ele responda. Assim, uma decisão incorreta não faz você perder nenhuma oportunidade. Consulte [Alterar sua decisão sobre uma inscrição processada](https://help.impact.com/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 as proteções de segurança, o nível de autonomia e a atribuição a grupos antes de ativar o agente. Consulte [Configurar e ativar o agente](https://help.impact.com/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).

</details>

<details>

<summary>Convidar possíveis parceiros (em breve)</summary>

O subagente Convidar possíveis parceiros aparece na configuração do agente com o rótulo Em breve. Para enviar e-mails aos possíveis parceiros adicionados pelo agente Descobrir, use um fluxo de trabalho de e-mail:

1. Crie um segmento de parceiros direcionado aos possíveis parceiros adicionados pelo Descobrir. Consulte [Entrar em contato com possíveis parceiros adicionados pelo agente de recrutamento](https://help.impact.com/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 fluxos de trabalho de e-mail explicados.
2. Crie um fluxo de trabalho de e-mail personalizado que use esse segmento e adicione seu e-mail de contato. Consulte [Criar e gerenciar fluxos de trabalho de e-mail](https://help.impact.com/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. Se preferir, envie as mensagens do seu próprio endereço de e-mail, em vez do endereço genérico da impact.com. Consulte [Conectar seu e-mail pessoal à sua conta da impact.com](https://help.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 aparecerá como opção ao configurar o e-mail do fluxo de trabalho.

</details>

## Proteja sua marca

O agente de recrutamento não adicionará os seguintes parceiros ao seu programa:

* Parceiros na sua [lista de bloqueio](https://help.impact.com/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 mais uma camada de proteção ativando *Salvaguardas de qualidade e segurança* no subagente Evaluate Applications. Consulte [Configurar o agente de recrutamento](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/set-up-the-recruitment-agent.md).

## Veja como o agente se encaixa na automação existente

Se você já usa [Fluxos de trabalho de candidaturas](https://help.impact.com/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), o Impact AI ou um webhook de candidatura, 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. Os fluxos de trabalho de candidaturas estão disponíveis nas edições Essential, Pro e Enterprise, e os 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 candidaturas 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 candidaturas.** Sua automação baseada em regras.
4. **Agente de recrutamento e seu webhook de candidatura.** O agente avalia as candidaturas que permaneceram pendentes após as etapas anteriores. Ao mesmo tempo, seu webhook de candidatura envia a candidatura ao endpoint que você configura em [retornos de notificação de eventos](https://help.impact.com/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 decisões por conta própria. Você pode enviar decisões de volta usando a API de processamento de candidaturas.

O agente de recrutamento nunca substitui uma decisão já tomada pelas etapas acima. Se um avaliador manual agir sobre uma candidatura antes de o agente terminar, a decisão manual prevalecerá.

{% hint style="success" %}
**Observação:** Como o agente de recrutamento e seu webhook de candidatura são executados ao mesmo tempo, o webhook pode enviar a candidatura antes de o agente terminar de avaliá-la. Para que o agente decida primeiro, adicione um atraso ao webhook na configuração de webhook da página Settings. Assim, o webhook enviará a candidatura após o atraso, incluindo a decisão do agente.
{% endhint %}

Se suas instruções incluírem regras rígidas e determinísticas, como "não aceite parceiros de fora dos EUA", considere adicioná-las também como fluxos de trabalho de candidaturas. Os fluxos de trabalho são mais rápidos e não consomem a capacidade do agente com decisões que não exigem raciocínio.

Para saber mais sobre a ordem dos fluxos de trabalho, consulte [Definir a ordem de execução dos fluxos de trabalho de candidaturas](https://help.impact.com/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).

## Gerenciar seus agentes

A página *Agentes* lista todos os agentes que você ativou. Na versão Beta, você pode configurar 1 agente de recrutamento.

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FfNdtzoQPSDPM4YuEPJSl%2Fagents.svg?alt=media\&token=4b2dbc3b-4ef9-4e55-a1e0-1ce46f425e9b) [**\[Agentes\]**](https://app.impact.com/secure/advertiser/agents/fr/agent-marketplace.ihtml).
   * Seu agente aparece como um cartão que mostra o status, a última atualização e ações rápidas.
2. No cartão do agente, escolha uma ação:
   * Selecione **Editar** para abrir o agente e ajustar as configurações.
   * Selecione **Executar descoberta** para iniciar uma execução de descoberta.
   * Passe o cursor sobre o cartão e selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FaMIlbqH54V4Ow5JvT0I0%2F%5BMore%5D%20vNext%202.svg?alt=media\&token=6d5449e8-e413-48fa-b059-58ebb3e2c271) **\[Mais]** para ver mais ações:
     * **Ver relatório:** Abra a *Visão geral do agente*, um resumo das execuções de descoberta, das decisões sobre candidaturas e do desempenho do agente. Consulte [Acompanhar os resultados do agente de recrutamento](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md#see-your-agents-overview).
     * **Ver prospects encontrados:** Abra a *Prospectos* página, filtrada para mostrar os prospectos adicionados pelo subagente Discover.
     * **Ver candidaturas avaliadas:** Abra a página *Candidaturas* página, filtrada para mostrar as candidaturas avaliadas pelo agente. Consulte [Acompanhar os resultados do agente de recrutamento](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md).
     * **Pausar:** Interrompe as execuções agendadas de descoberta e a avaliação de candidaturas recebidas. Os prospectos e as candidaturas existentes não são afetados.
     * **Excluir:** Remove o agente.

Para encontrar os resultados do seu agente, consulte [Acompanhar os resultados do agente de recrutamento](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/track-recruitment-agent-results.md).

### Atualizar as configurações do agente

Você pode ajustar a configuração de um agente ativo a qualquer momento. Na página *Agentes* selecione **Editar** no cartão do agente e faça qualquer uma destas alterações:

* Para renomear o agente, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F4lDm9hd6ePtF5al1oSaY%2F%5BEdit%5D.svg?alt=media\&token=70cab547-2f88-4901-861d-c832f66ac391) **\[Editar]** ao lado do nome do agente, na parte superior da página.
* Para editar as instruções, selecione **Editar** no painel *Instruções do agente* Consulte [Escrever instruções eficazes para agentes](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent/write-effective-agent-instructions.md).
* Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ativar]** ou ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FACIoqj1Ayhx8QzL9aqYB%2Ftoggle-off-solid%20\(1\).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. Consulte [Configurar o agente de recrutamento](https://help.impact.com/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 as alterações no nível do subagente, selecione **Atualizar** no canto superior direito para aplicá-las.

As alterações se aplicam às próximas execuções de descoberta e avaliações de candidaturas. O agente não reabre decisões anteriores.

## Siga as práticas recomendadas

* Faça testes antes de confirmar. Valide suas instruções com uma pequena execução do Discover e inicie o subagente Evaluate Applications no modo Copilot antes de ampliar o uso ou mudar para o Autopilot. Consulte [Escrever instruções eficazes para agentes](https://help.impact.com/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 por clique. Você pode fazer isso de duas maneiras:
  * No [*Relatório de produtividade de parceiros*](https://help.impact.com/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 tela *Inscrições* , defina o filtro **Processado por** como **Agente de recrutamento** para ver todas as inscrições avaliadas pelo agente.
* Entre em contato com parceiros recém-adicionados que já geraram cliques usando [Fluxos de e-mail](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/email-workflows.md) para ajudá-los nos próximos passos à medida que entram no seu programa.
* [Encerre os contratos](https://help.impact.com/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 adequados e 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=<question>&goal=<user_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.
