Português

Utilizar o Codex no Linear

Execute tarefas do Codex a partir de problemas do Linear

Utilize o Codex no Linear para delegar trabalho a partir de problemas. Atribua um problema ao Codex ou mencione @Codex num comentário, e o Codex cria uma conversa na cloud e responde com o progresso e os resultados.

O Codex no Linear está disponível em planos pagos (consulte Preços).

Se tiver um plano Enterprise, peça ao administrador do seu espaço de trabalho do ChatGPT que ative as conversas do Codex na cloud nas definições do espaço de trabalho e ative o Codex for Linear nas definições do conector.

Configurar a integração com o Linear

  1. Configure as conversas do Codex na cloud, ligando o GitHub no Codex e criando um ambiente para o repositório em que pretende que o Codex trabalhe.
  2. Aceda às definições do Codex e instale o Codex for Linear no seu espaço de trabalho.
  3. Associe a sua conta do Linear mencionando @Codex num fio de comentários de um problema do Linear.

Delegar trabalho ao Codex

Pode delegar de duas formas:

Atribuir um problema ao Codex

Depois de instalar a integração, pode atribuir problemas ao Codex da mesma forma que os atribui aos membros da equipa. O Codex começa a trabalhar e publica atualizações no problema.

Atribuição do Codex a um problema do Linear (modo claro)

Mencionar @Codex nos comentários

Também pode mencionar @Codex em fios de comentários para delegar trabalho ou fazer perguntas. Depois de o Codex responder, continue no fio para prosseguir com a mesma conversa.

Menção do Codex num comentário de um problema do Linear (modo claro)

Depois de o Codex começar a trabalhar num problema, escolhe um ambiente e um repositório onde trabalhar. Para fixar um repositório específico, inclua-o no seu comentário, por exemplo: @Codex fix this in openai/codex.

Para acompanhar o progresso:

  • Abra Atividade no problema para ver as atualizações de progresso.
  • Abra a ligação da conversa para acompanhar o trabalho com mais detalhe.

Quando o Codex termina, publica um resumo e uma ligação para a conversa concluída, para que possa criar um pull request.

Como o Codex escolhe um ambiente e um repositório

  • O Linear sugere um repositório com base no contexto do problema. O Codex seleciona o ambiente que melhor corresponde a essa sugestão. Se o pedido for ambíguo, recorre ao ambiente utilizado mais recentemente.
  • A conversa é executada no ramo predefinido do primeiro repositório indicado no mapa de repositórios desse ambiente. Atualize o mapa de repositórios no Codex se precisar de uma predefinição diferente ou de mais repositórios.
  • Se não estiver disponível nenhum ambiente ou repositório adequado, o Codex responderá no Linear com instruções para corrigir o problema antes de tentar novamente.

Atribuir problemas automaticamente ao Codex

Pode atribuir problemas automaticamente ao Codex através de regras de triagem:

  1. No Linear, aceda a Definições.
  2. Em As suas equipas, selecione a sua equipa.
  3. Nas definições do fluxo de trabalho, abra Triagem e ative-a.
  4. Em Regras de triagem, crie uma regra e escolha Delegar > Codex (e quaisquer outras propriedades que pretenda definir).

O Linear atribui automaticamente ao Codex os novos problemas que entram em triagem. Quando utiliza regras de triagem, o Codex executa as conversas através da conta do criador do problema.

Captura de ecrã de uma regra de triagem de exemplo que atribui tudo ao Codex e aplica uma etiqueta no estado "Triagem" (modo claro)

Utilização de dados, privacidade e segurança

Quando menciona @Codex ou lhe atribui um problema, o Codex recebe o conteúdo do problema para compreender o seu pedido e criar uma conversa. O tratamento de dados segue a Política de Privacidade, os Termos de Utilização e outras políticas aplicáveis da OpenAI. Para mais informações sobre segurança, consulte a documentação de segurança do Codex.

O Codex utiliza modelos de linguagem de grande dimensão que podem cometer erros. Reveja sempre as respostas e os diffs.

Sugestões e resolução de problemas

  • Ligações em falta: se o Codex não conseguir confirmar a sua ligação ao Linear, responde no problema com uma ligação para associar a sua conta.
  • Escolha inesperada do ambiente: responda no fio com o ambiente pretendido (por exemplo, @Codex please run this in openai/codex).
  • Parte errada do código: adicione mais contexto ao problema ou forneça instruções explícitas no seu comentário @Codex.
  • Mais ajuda: consulte o Centro de Ajuda da OpenAI.

Ligar o Linear para trabalho local (MCP)

Se estiver a utilizar a aplicação para computador do ChatGPT, o Codex CLI ou a extensão de IDE e pretender aceder localmente a problemas do Linear, configure o servidor Model Context Protocol (MCP) do Linear.

Para saber mais, consulte a documentação de MCP do Linear.

Os passos de configuração do servidor MCP são os mesmos, independentemente de utilizar a extensão de IDE ou a CLI, uma vez que ambas partilham a mesma configuração.

Utilizar a CLI (recomendado)

Se tiver a CLI instalada, execute:

codex mcp add linear --url https://mcp.linear.app/mcp

Isto solicita-lhe que inicie sessão com a sua conta do Linear e que a associe ao Codex.

Configurar manualmente

  1. Abra ~/.codex/config.toml no seu editor.
  2. Adicione o seguinte:
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
  1. Execute codex mcp login linear para iniciar sessão.