Conectar e Gerenciar Integrações

As Integrações conectam o Atoms às ferramentas e aos serviços que você já usa. Dependendo do conector, o Atoms pode usar informações externas enquanto ajuda você a criar, adicionar capacidades ao seu app publicado ou dar suporte a ambos os fluxos de trabalho.

Cada conector oferece suporte às suas próprias ações e permissões. Revise as capacidades e o escopo de permissão mostrados para o conector conectado; um painel de detalhes desconectado pode mostrar apenas sua descrição e o controle de conexão.

Use a conta com o menor privilégio e o escopo de permissão mínimo que possam concluir a tarefa. Não cole senhas, tokens de acesso, chaves privadas ou dados sensíveis não relacionados em um prompt. Quando um serviço contiver dados de produção ou de clientes, teste com uma amostra não sensível e verifique o destino exato antes de permitir uma gravação.

Os conectores e ações que você vê podem variar de acordo com a conta e a versão. Abra o catálogo de Conectores no Atoms para ver o que está disponível para você no momento.

Decida o que a conexão deve fazer

Antes de conectar um serviço, decida onde você precisa dele.

Objetivo	Exemplos
Dar contexto ao Agente enquanto você cria	Encontrar arquivos, resumir tarefas, revisar problemas ou usar dados do projeto em um prompt
Permitir que o Agente execute uma ação em outro serviço	Criar uma tarefa, atualizar um registro, adicionar dados a uma planilha ou criar um evento no calendário
Adicionar um serviço ao app publicado	Armazenar dados do aplicativo, lidar com autenticação, processar pagamentos ou executar um fluxo de trabalho do app

Alguns conectores oferecem suporte a mais de um objetivo. Revise a descrição do conector e as permissões solicitadas antes de conectá-lo.

Conectar uma integração

Abra Configurações → Conectores para usar o ponto de entrada principal. Você também pode selecionar Conecte suas ferramentas ao Atoms no painel.

Conectar ou desconectar uma integração pode exigir acesso de proprietário do espaço de trabalho ou de administrador autorizado. Se você não for um proprietário ou administrador e um controle não estiver disponível, peça ao proprietário do espaço de trabalho ou a um administrador autorizado.

Pelo painel

Abra o painel do Atoms.
Selecione Conecte suas ferramentas ao Atoms.
Escolha o conector que você deseja usar. Siga o controle de conexão mostrado no cartão desse conector.
Use o controle mostrado para esse conector. Se ele abrir um painel de detalhes genérico, selecione Conectar; integrações específicas do provedor podem abrir seu próprio fluxo de configuração ou autorização.
Entre no serviço externo, se solicitado.
Revise a conta e as permissões e, em seguida, aprove a conexão.
Volte ao Atoms e confirme que o conector aparece como conectado. No Chat em que você deseja usá-lo, abra o seletor de conectores e habilite o conector para esse Chat.

Usar uma integração conectada

Diga ao Agente qual serviço usar e inclua detalhes suficientes para identificar o item correto. Detalhes úteis incluem:

O nome do projeto, espaço de trabalho, repositório, pasta, calendário ou planilha
O nome de uma tarefa, ID do problema, nome do arquivo ou identificador do registro
Um intervalo de datas, data de vencimento, responsável, status ou prioridade
O que você quer que o Atoms leia, resuma, crie ou atualize

Por exemplo:

“Resuma os problemas de alta prioridade do Linear atribuídos a mim.”
“Encontre o briefing de lançamento no Drive e liste as decisões em aberto.”
“Adicione estes leads aprovados à planilha da campanha.”
“Crie um evento no calendário para a revisão de design na próxima terça-feira às 15h.”

O Atoms só pode usar ações compatíveis com o conector e dados disponíveis para a conta conectada. Se a capacidade ou ação de que você precisa não for mostrada para esse conector, pare e não presuma que ela é compatível.

Revise alterações externas antes que sejam executadas

Quando um conector e uma ação oferecem suporte à criação ou atualização de dados externos, o Atoms pode mostrar uma confirmação antes de executá-la.

Revise:

O serviço e a conta conectada
O arquivo, planilha, calendário, projeto ou registro de destino
As informações que serão criadas ou alteradas
Qualquer data, hora, destinatário ou outro valor importante

Se o Atoms mostrar uma confirmação, revise-a e selecione Confirmar para continuar ou cancelar para deixar o serviço externo inalterado. A disponibilidade de gravação depende do conector e da ação; conectores somente leitura não oferecem ações de gravação.

Após uma gravação, verifique o resultado no serviço externo antes de tentar novamente. Se o destino ou os valores estiverem errados, interrompa o fluxo de trabalho e use o histórico, desfazer ou as ferramentas de recuperação do próprio provedor, quando disponíveis. Desconectar um conector interrompe o uso futuro; isso não reverte alterações já feitas.

Gerenciar uma conexão

Abra o catálogo de Conectores e selecione um serviço conectado para revisar seu status atual.

No painel de detalhes do conector, você pode conseguir:

Verificar qual conta está conectada
Revisar as ações compatíveis do conector e o escopo de permissão
Reconectar quando a autorização tiver expirado
Atualizar ou alterar o acesso quando o serviço oferecer suporte a isso
Desconectar a conta do Atoms

Desconectar no Atoms interrompe o uso futuro da conexão. Alguns serviços também podem exigir que você revogue o Atoms nas configurações de conta ou segurança do próprio serviço.

Exemplos por caso de uso

A tabela abaixo é um agrupamento editorial por caso de uso, não um conjunto de categorias do catálogo. Use o catálogo pesquisável para ver a lista atual de conectores disponíveis.

Categoria	Usos comuns	Exemplos
Desenvolvimento	Controle de código-fonte, repositórios, problemas e fluxos de entrega	GitHub, Linear
Backend e dados	Bancos de dados, autenticação, armazenamento e dados estruturados	Supabase
Pagamentos	Checkout, faturamento e fluxos de pagamento	Stripe
Gestão de trabalho	Tarefas, projetos, responsáveis e datas de vencimento	Asana, Todoist
Arquivos e conteúdo	Pesquisar, ler e organizar arquivos externos	Box, Dropbox
Analytics e marketing	Tráfego, desempenho de busca, campanhas e relatórios	Google Analytics 4, Google Search Console, Google Ads

A disponibilidade dos conectores muda com o tempo. Use o catálogo no Atoms para ver a lista atual e abra um conector para revisar suas capacidades exatas.

Guias de configuração

Escolha o guia para o seu serviço:

Para problemas de conexão, consulte solução de problemas de Integração.

Esta página foi útil?