> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integração com o Pylon

> Conecte o Pylon ao Devin para escalar tickets de suporte para a engenharia, delegar problemas a sessões do Devin e acionar automações a partir de eventos do Pylon.

<Note>
  A integração com o Pylon está em beta. Entre em contato com [mitchell.tan@cognition.ai](mailto:mitchell.tan@cognition.ai) para solicitar acesso.
</Note>

Com a integração com o Pylon, você pode iniciar sessões do Devin, fazer perguntas sobre a base de código e acionar automações diretamente do Pylon. O Devin envia atualizações da sessão para o problema vinculado no Pylon.

Com o Pylon conectado, você pode:

* **Delegar problemas**: inicie uma sessão a partir de um problema do Pylon, com o ticket já no contexto.
* **Fazer perguntas**: pergunte sobre sua base de código diretamente do Pylon. Também é possível permitir perguntas de pessoas sem conta do Devin.
* **Acionar automações**: inicie sessões quando um problema for criado, receber uma tag ou mudar de status.
* **Usar ferramentas do Pylon**: permita que o Devin leia problemas, contas e contatos, com acesso de escrita opcional para problemas e contas.

<Warning>
  Tickets de suporte ao cliente são conteúdo não confiável e podem conter tentativas de injeção de prompt. Ao conectar a integração, o Devin cria um [perfil de segurança do Pylon](#security-profile) restritivo. Revise-o antes de habilitar fluxos de trabalho.
</Warning>

<h2 id="setting-up-the-integration">
  Configurando a integração
</h2>

Você precisa ser administrador tanto no Pylon quanto no Devin para conectar a integração.

1. Acesse [Configurações > Conexões > Pylon](https://app.devin.ai/settings/connections/pylon) e clique em **Connect**.
2. Faça login no Pylon e autorize o acesso do Devin.
3. De volta ao Devin, revise as configurações de [controle de acesso](#access-control) e ative os recursos de que você precisa.
4. Revise o [perfil de segurança do Pylon](#security-profile) criado automaticamente e confirme que ele atende ao seu fluxo de trabalho.

Esta conexão inclui ferramentas nativas por meio do servidor MCP hospedado pelo Pylon. Não é necessário instalar o MCP do Pylon separadamente.

<Note>
  Nos planos Enterprise, gerencie o Pylon a partir da organização principal. Essas configurações se aplicam a todo o Enterprise. Se o seu Enterprise tiver várias organizações, escolha uma em [roteamento de sessões](#session-routing) antes de usar a integração.
</Note>

<h2 id="connecting-your-pylon-user-account">
  Conectando sua conta de usuário do Pylon
</h2>

Vincule sua conta do Pylon à sua conta do Devin para que as sessões delegadas sejam atribuídas a você.

Acesse [Configurações > Conexões > Pylon](https://app.devin.ai/settings/connections/pylon) e clique em **Link user profile** ou vincule sua conta em [Personal Connections](https://app.devin.ai/account/connections).

<h2 id="access-control">
  Controle de acesso
</h2>

Configure estas opções na página de conexão do Pylon.

| Configuração | O que faz |
| - | - |
| **correspondência de usuários** | **Pylon-connected users only** exige que cada membro [vincule sua conta do Pylon](#connecting-your-pylon-user-account). **Email or Pylon-connected user** também reconhece remetentes cujo e-mail no Pylon corresponda ao e-mail de um membro de uma conta do Devin. |
| **Ask without a Devin account** | Permite que pessoas sem conta do Devin façam perguntas. As respostas se baseiam nos repositórios indexados, sem alterações de código, comandos ou ferramentas. Em planos Enterprise com várias organizações, escolha a organização responsável pelas respostas em **If not linked, route to**. |
| **gatilhos de automação do Pylon** | Permite que eventos do Pylon [acionem automações](#triggering-devin-from-pylon). |
| **acesso ao Pylon MCP** | **Read only** permite que as sessões leiam problemas, contas e contatos do Pylon. **Read and write** também permite criar problemas e atualizar campos de problemas e de contas. |
| **Pylon follow-up messages** | Permite que o bot do Pylon encaminhe atualizações, como novas respostas de clientes, para a sessão do Devin vinculada. |

<Note>
  As ferramentas do Pylon no Devin não podem criar rascunhos de mensagens para clientes nem enviar respostas a eles. As ações de escrita se limitam a campos de problemas e de contas.
</Note>

<h3 id="security-profile">
  Perfil de segurança
</h3>

Ao conectar o Pylon, é criado um perfil chamado **perfil de segurança do Pylon**, que é definido como padrão para sessões delegadas. Contas Enterprise recebem um perfil Enterprise compartilhado; as demais contas recebem um perfil de organização.

O perfil vem com estas configurações iniciais:

| Configuração | Padrão |
| - | - |
| **Acesso à rede** | Permite `usepylon.com` e `*.usepylon.com`, além dos destinos exigidos pelo Devin e das conexões MCP permitidas. Todo o restante do tráfego de saída é bloqueado. |
| **Acesso ao Git** | Somente leitura: o Devin pode clonar repositórios e executar fetch, mas não pode fazer push de branches nem abrir PRs. |
| **Acesso ao Devin MCP** | Somente leitura: o Devin pode ler os próprios recursos, mas não pode criar sessões filhas nem modificar recursos como playbooks. |
| **Token da GitHub CLI** | Não é fornecido à sessão. |
| **Lista de permissões de servidores MCP** | Não é restringida por este perfil. O **Devin MCP somente leitura** não torna as ferramentas MCP de terceiros somente leitura; as gravações no Pylon são controladas separadamente pelo **acesso ao Pylon MCP**. |
| **Aplicação** | [Obrigatória](/pt-BR/product-guides/security-profiles#mandatory-vs-recommended-enforcement). |

Para alterar a seleção, use **Security → Default security profile** na página de conexão do Pylon. Para editar as restrições do perfil, abra [Perfis de segurança](/pt-BR/product-guides/security-profiles). Para isso, é necessário ter permissão para gerenciar perfis de segurança no nível da organização ou no nível Enterprise, respectivamente. Reconectar o Pylon mantém as edições já feitas no perfil e as seleções padrão.

**Onde se aplica:**

* **Sessões delegadas** usam o padrão do Pylon configurado no momento em que são criadas.
* **Automações** têm sua própria seleção de perfil. Ao adicionar um acionador do Pylon, o editor pré-seleciona o perfil do Pylon configurado, desde que você tenha permissão para selecioná-lo e ainda não tenha escolhido outro perfil nem optado por não usar nenhum. Revise o **Perfil de segurança** da automação antes de salvar. Alterar o padrão do Pylon não substitui os perfis já salvos nas automações.
* **Perguntas somente de consulta** usam repositórios indexados sem iniciar uma sessão baseada em VM.

Você pode selecionar outro perfil, herdar os padrões da organização ou do Enterprise, ou não usar nenhum perfil. As restrições obrigatórias definidas em outros níveis da hierarquia de perfis continuam valendo.

<Note>
  O perfil padrão do Pylon **não** permite abrir PRs. Se o seu fluxo de trabalho precisar desse recurso, um administrador autorizado deve configurar um acesso ao Git adequado. Reproduções que baixam dependências ou chamam serviços externos também podem exigir destinos de rede adicionais. Limite as permissões ao estritamente necessário para o fluxo de trabalho.
</Note>

<h3 id="session-routing">
  Roteamento de sessões
</h3>

O roteamento de sessões está disponível **somente nos planos Enterprise**. Em **roteamento de sessões**, selecione a **organização** em que as sessões do Pylon devem ser executadas. Contas Enterprise com várias organizações precisam selecionar uma antes de usar a integração; até que isso seja feito, os eventos do Pylon serão rejeitados. Contas com uma única organização usam essa organização automaticamente.

<h2 id="working-with-devin-in-pylon">
  Trabalhando com Devin no Pylon
</h2>

<h3 id="delegate-an-issue">
  Delegar um problema
</h3>

Abra o painel do Devin no lado direito de um problema do Pylon e descreva a tarefa. O ticket já está no contexto, e você também pode anexar capturas de tela ou arquivos de log.

Uma sessão completa exige uma conta do Devin reconhecida pela [correspondência de usuários](#access-control), com acesso à organização selecionada. Se algum desses requisitos não for atendido, o Devin explica o motivo no problema.

O Devin publica no problema seu plano, os comandos, as edições de arquivos, os PRs e o link da sessão. Ele também avisa você quando para e fica aguardando uma resposta. Essas atualizações são automáticas; não é preciso configurar um gatilho no Pylon.

* **Dar continuidade**: responda na thread do Devin no problema com mais instruções.
* **Arquivar**: responda `archive` (ou `@Devin archive`) para arquivar a sessão.
* **Continuar em outro lugar**: use a mesma sessão no web app do Devin ou em threads do Slack vinculadas pelo Pylon.

<h3 id="ask-about-your-codebase">
  Pergunte sobre sua base de código
</h3>

Faça uma pergunta sobre a base de código pelo Pylon, como "Como funciona a verificação de assinatura de webhook?". O Devin responde com base nos repositórios indexados, sem iniciar uma sessão completa nem fazer alterações. Para incluir pessoas que não têm uma conta do Devin, habilite **Ask without a Devin account**.

<h3 id="slack-threads">
  Threads do Slack
</h3>

[Conecte o Slack](/pt-BR/integrations/slack) e convide o Devin para os seus canais de escalonamento. O Devin pode acompanhar threads do Slack vinculadas a um problema do Pylon e receber as respostas na sessão. Responda `@Devin archive` em uma thread monitorada para arquivar a sessão.

<h2 id="triggering-devin-from-pylon">
  Acionando o Devin a partir do Pylon
</h2>

Use [automações](/pt-BR/product-guides/automations) para iniciar sessões a partir de eventos do Pylon. Primeiro, ative os **gatilhos de automação do Pylon** em [controle de acesso](#access-control).

1. Acesse **automações** e crie uma nova automação.
2. Adicione um gatilho, escolha **Pylon** e selecione um evento:
   * **Issue created**: um novo problema é registrado. Se quiser, filtre por **Title**.
   * **Tag added**: uma tag é adicionada a um problema. Escolha a **Added Tag** correspondente.
   * **Status changed**: um problema muda para determinado status. Escolha o **Status** correspondente.
3. Adicione uma ação **Start session** e escreva as instruções para o Devin.
4. Revise o [perfil de segurança](#security-profile), o acesso à rede e as ferramentas da automação e salve.

Há dois templates para ajudar você a começar:

* **Triage Customer Bug Tickets**: investiga problemas recém-registrados, tenta reproduzir bugs e relata os resultados ao suporte.
* **Investigate Support Escalations**: investiga problemas com tags, tenta reproduzir o bug, sugere uma correção e relata os resultados na thread interna do Slack.

<Tip>
  Configure o gatilho para uma tag de escalonamento, em vez de para cada novo problema, e assim mantenha os tickets rotineiros fora do fluxo de trabalho da engenharia.
</Tip>

<h2 id="escalating-support-tickets-to-engineering">
  Escalonando tickets de suporte para a engenharia
</h2>

Um escalonamento típico segue este fluxo:

1. Um cliente relata um problema no Pylon.
2. Uma skill do Pylon ou a detecção por IA do tipo de problema identifica um bug com detalhes suficientes para reprodução e adiciona uma tag de escalonamento.
3. A tag aciona uma automação do Devin.
4. O Devin lê o ticket, verifica os logs e as ferramentas de monitoramento conectados e tenta reproduzir a falha. Se o perfil de segurança permitir, o Devin pode abrir um PR.
5. O Devin publica os resultados no Slack e as atualizações de progresso no problema do Pylon.
6. Um engenheiro revisa a investigação e dá continuidade na thread do Slack.

<h3 id="set-up-the-pylon-side">
  Configure o lado do Pylon
</h3>

Use uma skill do Pylon ou a detecção por IA do tipo de problema para marcar com uma tag os tickets que precisam ser escalonados. Use a mesma tag no filtro **Added Tag** da automação do Devin. Defina fluxos separados para bugs sem detalhes de reprodução e para tickets que não são bugs.

<h3 id="set-up-the-devin-automation">
  Configure a automação do Devin
</h3>

1. Abra a [galeria de templates de automação](https://app.devin.ai/automations/templates) e escolha **Investigate Support Escalations**.
2. No gatilho pré-configurado **Pylon → Tag added**, defina **Added Tag** como a sua tag de escalonamento.
3. Revise o prompt e o [perfil de segurança](#security-profile). O template instrui o Devin a investigar a causa raiz, tentar reproduzir o problema, sugerir uma correção e relatar os resultados na thread interna do Slack do Pylon.
4. Configure o acesso ao Slack conforme descrito abaixo e clique em **Criar automação**.

Liste apenas as ferramentas e os repositórios que o Devin pode acessar. Conecte ferramentas de observabilidade, como [Datadog](/pt-BR/enterprise/integrations/datadog) ou [Sentry](/pt-BR/enterprise/integrations/sentry), para que as sessões possam verificar o comportamento em produção.

<h3 id="post-findings-in-pylons-internal-slack-thread">
  Publique os resultados na thread interna do Slack criada pelo Pylon
</h3>

Um fluxo de trabalho comum é fazer o Pylon publicar um resumo do ticket em um canal interno do Slack e, em seguida, fazer o Devin responder com seus resultados nessa mesma thread.

1. [Conecte o Slack](/pt-BR/integrations/slack) e convide o Devin para o canal interno em que o Pylon publica.
2. Dê à automação a ferramenta **Slack** e acesso a esse canal.
3. No prompt da automação, instrua o Devin a publicar os resultados na thread criada pelo Pylon, em vez de enviar uma nova mensagem de nível superior. O template **Investigate Support Escalations** já inclui esta instrução:

   > Se houver uma thread interna do Slack em um canal no qual o Pylon tenha publicado uma atualização, encontre essa thread de nível superior e publique seus resultados nela.

<h3 id="automatic-updates-in-pylon">
  Atualizações automáticas no Pylon
</h3>

A integração publica automaticamente notas internas no problema vinculado do Pylon quando ocorrem eventos como a abertura de um PR. Você não precisa configurar um gatilho no Pylon para essas notas.

<h4 id="optional-custom-pylon-triggers">
  Gatilhos personalizados opcionais no Pylon
</h4>

Para ações adicionais além das atualizações nativas, pesquise **devin** no construtor de gatilhos do Pylon para encontrar estas condições:

* Devin abriu um PR
* Devin fez merge de um PR
* Devin fechou um PR
* Devin está aguardando uma resposta

Use essas condições para atualizar o status do problema quando um PR for aberto, notificar o responsável pela conta quando for feito o merge ou atribuir o problema a uma pessoa quando o Devin precisar de uma resposta. Para a configuração no Pylon, consulte [escalonamento de agente para agente via Devin](https://support.usepylon.com/articles/6981171768-agent-to-agent-escalation-via-devin).

<h2 id="disconnecting-pylon">
  Desconectando o Pylon
</h2>

Acesse [Configurações > Conexões > Pylon](https://app.devin.ai/settings/connections/pylon), clique em **Disconnect** e confirme. Com isso, os eventos do Pylon deixam de ativar as automações do Devin.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.