Integrações
Integrações conectam o AI Cockpit Lens a ferramentas externas por meio de adapters. Cada adapter armazena detalhes de conexão em nível de organização, como API keys, tokens, URLs base e informações de conta, para que workflows, importações de bases de conhecimento, sincronizações ou ações de entrega possam usar sistemas externos.
Quando usar
- Use integrações para configurar credenciais de ferramentas externas.
- Use-as para permitir que workflows enviem resultados a sistemas conectados.
- Use-as para importar contexto de projeto para bases de conhecimento quando essa ação estiver disponível.
- Use-as para manter bases de conhecimento sincronizadas com dados externos de projeto ou gestão de trabalho.
Antes de começar
- Confirme a organização ativa.
- Confirme que sua função pode gerenciar adapters.
- Tenha as informações de conexão necessárias antes de salvar credenciais.
- Revise qualquer workflow ou base de conhecimento que dependa de um adapter antes de desativá-lo.
Passo a passo: navegar por adapters
- Abra o menu da conta.
- Clique em Adapters ou na opção de integrações disponível.
- Revise os cards das integrações disponíveis para a organização.
- Clique em um adapter para abrir sua configuração.
Passo a passo: criar um adapter
- Clique em Adicionar Adapter.
- Informe nome, identificador, descrição e imagem opcional.
- Clique em Criar Adapter.
- Abra o adapter para configurar credenciais quando houver uma tela de configuração disponível.
Passo a passo: configurar um adapter de gestão de trabalho
- Abra o adapter.
- Informe a URL base.
- Informe a conta ou usuário exigido pela integração.
- Informe o token de API ou credencial de acesso.
- Clique em Salvar Credenciais.
Passo a passo: configurar um adapter de modernização
- Abra o adapter.
- Informe a URL base.
- Informe a API key ou credencial de acesso.
- Clique em Salvar Credenciais.
Ações que exigem cuidado
| Ação | O que acontece |
|---|---|
| Limpar credenciais | Remove as credenciais salvas para aquele adapter. |
| Desativar adapter | Remove o adapter do uso ativo até que seja reativado ou configurado novamente. |
cuidado
Limpar credenciais ou desativar um adapter pode interromper workflows, importações ou ações de entrega que dependem dele.
Padrões de integração suportados
| Integração | Uso comum no Lens |
|---|---|
| Jira | Sincroniza boards, épicos e histórias para bases de conhecimento e pode criar issues ou cards a partir de saídas de workflow. |
| BusinessMap | Sincroniza boards e cards para contexto visual de gestão de trabalho e pode criar cards a partir de saídas de workflow. |
| Azure DevOps | Sincroniza work items, boards e backlogs para bases de conhecimento em contextos de projeto Microsoft. |
| Modernization | Importa backlog e status de projeto para manter bases de conhecimento de modernização alinhadas ao trabalho ativo de migração. |
Resultado esperado
Depois da configuração, o Lens deve conseguir usar o adapter em workflows, importações ou ações de entrega suportadas pelo ambiente.
Dicas e problemas comuns
- Se uma importação falhar, confirme que as credenciais do adapter ainda são válidas.
- Se um workflow não consegue entregar um resultado, verifique se o adapter está ativo.
- Se um card de adapter não aparece, a organização pode não ter aquela integração habilitada.