API de IA do Confluence: O guia completo para desbloquear sua base de conhecimento

O espaço Confluence da sua empresa provavelmente está a transbordar de informação. Tem de tudo, desde planos de projeto e documentos técnicos densos até às mais recentes políticas de RH. Mas extrair esse conhecimento e colocá-lo a trabalhar automaticamente pode ser uma verdadeira dor de cabeça. Muitas vezes, parece que tem uma biblioteca cheia de livros valiosos, mas estão todos trancados a sete chaves.

Muitas equipas querem usar os seus dados do Confluence para alimentar coisas como bots de ajuda interna ou assistentes para clientes. A ideia é ótima, mas quando tentam construí-lo, geralmente esbarram numa parede. Acontece que o caminho não é tão simples como se poderia pensar.

Este guia irá guiá-lo por todas as opções reais para criar uma "API de IA do Confluence". Vamos analisar o que a Atlassian oferece de origem, o que é preciso para o construir você mesmo (spoiler: muito), e como algumas plataformas de terceiros podem dar-lhe um atalho muito necessário.

O que é a API de IA do Confluence?

Primeiro, vamos esclarecer algo. Uma "API de IA do Confluence" não é um produto oficial que possa comprar da Atlassian. É realmente apenas um nome para o método que usa para aceder a todo o conhecimento no Confluence para alimentar uma aplicação de IA, como um chatbot que pode responder a perguntas usando a sua documentação interna.

Existem geralmente duas maneiras como as pessoas tentam fazer isso:

1. A Forma Direta: Você usa a API REST padrão do Confluence para extrair todos os dados brutos da página e depois injetá-los num sistema de IA que construiu você mesmo.

2. A Forma de Terceiros: Você usa uma plataforma que já tem um conector para o Confluence e fornece a camada de IA para si, poupando-lhe imenso trabalho.

Mas aqui está o maior obstáculo que precisa de saber agora mesmo: até ao final de 2024, a Atlassian não tem uma API pública para as suas próprias funcionalidades de IA (que talvez conheça como Atlassian Intelligence ou Rovo). Isto é um obstáculo gigantesco. Significa que pode usar a IA deles dentro de uma página do Confluence, mas não pode usá-la para alimentar as suas próprias aplicações, como um bot no Slack ou um assistente no seu site.

Funcionalidades nativas de IA da Atlassian

A Atlassian Intelligence (recentemente integrada numa reformulação de marca chamada Rovo) é a IA própria da empresa, incorporada diretamente nos seus produtos. Foi realmente projetada para o ajudar a fazer as coisas mais rapidamente dentro do ecossistema Atlassian.

Para tarefas do dia a dia, as suas funcionalidades são bastante úteis. Pode usá-la para:

• Resumir páginas longas e sinuosas ou threads de comentários confusos.

• Elaborar um primeiro rascunho de um documento a partir de um prompt rápido.

• Aprimorar a sua escrita, alterando o tom ou corrigindo erros gramaticais.

• Encontrar respostas para perguntas com base no que está dentro da sua instância do Confluence.

Tudo parece muito bom, mas assim que se aprofunda um pouco, as limitações começam a aparecer.

Principais limitações da Atlassian Intelligence

Apesar de ser prática para tarefas pontuais, a IA da Atlassian simplesmente não funciona quando se quer construir qualquer tipo de fluxo de trabalho automatizado ou ferramenta personalizada.

O maior problema é a questão da falta de uma API pública de que acabámos de falar. Este é o verdadeiro obstáculo. Fica completamente confinado ao ecossistema deles. Quer construir um bot que ajude os funcionários a encontrar informações de RH no Microsoft Teams? Ou um assistente de IA para ajudar os seus agentes de suporte no Zendesk? A Atlassian Intelligence não pode ajudá-lo com isso. É um circuito fechado.

Depois, há o problema do conhecimento em silos. A IA só sabe o que está dentro das suas ferramentas Atlassian. Mas sejamos honestos, onde é que a sua equipa realmente guarda toda a sua informação? Provavelmente está espalhada por todo o lado, em Google Docs, Notion, tickets de suporte antigos e quem sabe onde mais. A IA da Atlassian não consegue ver nada disso, por isso as respostas que dá serão sempre incompletas.

A plataforma também é bastante rígida. Não pode adicionar as suas próprias ações ou fluxos de trabalho personalizados. E se quiser que a sua IA faça mais do que apenas encontrar uma resposta? Talvez precise que ela procure a encomenda de um cliente no Shopify ou crie um ticket no Jira Service Management. Com as ferramentas nativas da Atlassian, está preso. O que vê é o que obtém.

Finalmente, tem de pensar nas restrições de custo e de plano. Só tem acesso a estas funcionalidades de IA em certos planos de subscrição, e mesmo assim, o seu uso é limitado.

Compreender os preços da Atlassian Intelligence

A Atlassian inclui as suas funcionalidades de IA nos seus planos Confluence Cloud. Para obter algo útil, tem de estar num plano pago, e quanto mais pagar, mais "créditos de IA" recebe para gastar a cada mês.

Aqui está um rápido resumo de como as funcionalidades de IA se distribuem pelos diferentes planos:

Funcionalidade	Grátis	Standard	Premium	Enterprise
Preço (por utilizador/mês)	$0 (até 10 utilizadores)	A partir de $5,16	A partir de $9,73	Contactar Vendas
Atlassian Rovo (IA)	Não	Sim	Sim	Sim
Créditos de IA por utilizador/mês	0	25	70	150
Principais Funcionalidades de IA	N/D	Pesquisa Rovo, Chat e Agentes	Tudo do Standard	Tudo do Premium

Com este modelo de preços, é constantemente empurrado para os planos mais caros para tirar algum proveito real da IA. E mesmo que opte pelo nível Enterprise, o seu uso é limitado por um sistema de créditos, o que pode tornar-se imprevisível e caro à medida que a sua equipa começa a usá-lo mais. Pode consultar todos os detalhes na página de preços oficial do Confluence.

A abordagem ‘faça você mesmo’ para construir uma API de IA do Confluence

Ok, então se as ferramentas incorporadas não são suficientes, por que não construí-la você mesmo? Esta é uma ideia tentadora, especialmente para empresas com uma equipa de engenharia talentosa. O processo geralmente tem este aspeto:

1. Obter os dados: Primeiro, usa a API REST do Confluence para descarregar todas as páginas e ficheiros que quer que a IA conheça.

2. Limpar os dados: É aqui que a diversão começa. O conteúdo do Confluence é muitas vezes uma mistura confusa de HTML ou XML. Tem de analisar tudo isso para obter texto limpo e simples.

3. Dividir em pedaços: Os modelos de IA não conseguem ler um documento inteiro de 10 páginas de uma só vez. Tem de dividir o conteúdo em pedaços mais pequenos e lógicos.

4. Transformar em vetores: Em seguida, usa um modelo de embedding (como um da OpenAI) para converter esses pedaços de texto numa série de números chamados vetores. É basicamente como transformar o seu texto em coordenadas num mapa.

5. Armazenar: Depois, coloca todos esses vetores numa base de dados vetorial especial como Milvus, Pinecone ou Chroma, que é projetada para fazer pesquisas super-rápidas por pedaços de texto semelhantes.

6. Construir a aplicação: Finalmente, tem de construir a aplicação real que recebe a pergunta de uma pessoa, transforma-a num vetor, encontra os pedaços mais relevantes da sua base de dados e envia todo esse contexto para um modelo de linguagem grande (LLM) para gerar uma resposta.

Porque é que o método ‘faça você mesmo’ é um projeto enorme

Se isso parece muito trabalho, é porque é. Este não é um projeto de fim de semana. É um investimento sério de engenharia que vem com uma série de problemas que terá de resolver.

Para começar, precisa de competências técnicas sérias. Este não é um trabalho para o seu helpdesk de TI. Precisa de uma equipa de engenheiros que se sintam à vontade com APIs, processamento de dados, ferramentas de machine learning como LangChain e gestão de bases de dados.

Também encontrará alguns obstáculos com a API do Confluence. Como muitos programadores nos fóruns da comunidade Atlassian lhe dirão, a API tem as suas peculiaridades. Tem de lidar com a paginação (puxar dados em pequenos lotes), ter cuidado para não atingir os limites de taxa e ser bloqueado, e descobrir uma forma fiável de limpar a formatação confusa nas páginas do Confluence.

Depois, tem os custos ocultos e o trabalho contínuo. As despesas não são apenas os salários dos programadores. Está a pagar por chamadas de API a um modelo de embedding cada vez que um documento é adicionado ou atualizado. Está a pagar para alojar a base de dados vetorial. E está a pagar com tempo pela manutenção constante necessária para lidar com alterações na API, corrigir bugs e simplesmente manter tudo a funcionar. Pode facilmente tornar-se um trabalho a tempo inteiro para uma equipa inteira.

Este guia detalha como mergulhar na API do Confluence, que é uma parte fundamental da abordagem DIY.

Usar uma plataforma de terceiros para uma API de IA do Confluence

Depois de analisar as duas primeiras opções, pode estar a pensar que tem de haver uma maneira melhor. E há. A solução é uma plataforma de IA tudo-em-um que faz todo o trabalho complicado de backend por si. Estas plataformas dão-lhe uma camada de IA pronta a usar que se conecta diretamente ao Confluence e às suas outras ferramentas, oferecendo o poder de uma solução personalizada sem nenhuma das dores de cabeça.

Porque é que uma plataforma dedicada é a escolha prática

A diferença é como da noite para o dia. Em vez de um projeto que levará meses à sua equipa de engenharia, pode estar a postos e a funcionar em poucos minutos. Uma boa plataforma permite-lhe conectar as suas ferramentas e lançar um assistente de IA numa única tarde.

As melhores plataformas também o ajudam a reunir todo o seu conhecimento. Elas não se conectam apenas ao Confluence. Também se podem conectar a tudo o resto, como os seus Google Docs, Notion, tickets antigos do Zendesk e histórico do Slack. Isto cria um único "cérebro" unificado para a sua IA, permitindo-lhe dar respostas que são realmente completas.

Também obtém funcionalidades poderosas imediatamente. Coisas como um ambiente de simulação para testar a sua IA, análises para encontrar lacunas no seu conhecimento, ou ações de IA personalizáveis são incrivelmente complexas de construir do zero. Uma plataforma dedicada dá-lhe tudo isso de imediato.

Apresentando a eesel AI: A API de IA do Confluence sem código

É aqui que uma ferramenta como a eesel AI realmente faz a diferença. Foi construída para lhe dar a flexibilidade de uma "API de IA do Confluence" personalizada sem que tenha de escrever uma única linha de código.

Conectar o Confluence à eesel AI é uma integração de um clique. Basta autorizar a aplicação e está feito. Não há que mexer com chaves de API, configurar bases de dados ou escrever scripts para limpar os seus dados.

A eesel AI torna a conexão da sua API de IA do Confluence com outras aplicações um processo de um clique.

Mas a parte realmente interessante são as ações de IA personalizáveis. É isto que lhe dá a flexibilidade de que realmente precisa. Com a eesel AI, pode configurar a sua IA para fazer mais do que apenas responder a perguntas. Ela pode fazer a triagem de um ticket de suporte no Intercom, procurar detalhes de uma encomenda na sua base de dados, ou enviar uma escalada para um canal específico do Slack. Pode verdadeiramente automatizar um fluxo de trabalho do início ao fim.

Com uma plataforma de terceiros para a API de IA do Confluence, pode configurar regras e ações personalizadas sem qualquer programação.

Também obtém um controlo preciso com conhecimento delimitado. Pode facilmente decidir quais os espaços do Confluence ou até mesmo quais as páginas que a IA tem permissão para usar em diferentes situações. Isto garante que o seu bot de vendas não começa a tentar responder a perguntas usando documentos de engenharia, mantendo tudo relevante.

O melhor de tudo é que pode testar tudo com confiança. A eesel AI vem com um modo de simulação que lhe permite testar a sua IA em milhares das suas conversas passadas. Pode ver exatamente como ela se teria comportado e qual teria sido a sua taxa de automação antes de a deixar falar com um único utilizador real. Este tipo de teste sem risco simplesmente não é possível com uma configuração ‘faça você mesmo’ e é algo que a maioria das outras ferramentas não oferece.

O modo de simulação permite-lhe testar a sua API de IA do Confluence em conversas passadas para prever o desempenho.

Pare de construir, comece a automatizar com uma API de IA do Confluence

Então, analisámos três maneiras diferentes de extrair o conhecimento da sua instância do Confluence:

1. IA Nativa da Atlassian: Fácil para tarefas simples dentro da aplicação, mas demasiado limitada para construir ferramentas personalizadas, uma vez que não tem API pública.

2. A Abordagem DIY: Poderosa se conseguir implementá-la, mas é incrivelmente complexa, cara e uma enorme distração do seu negócio principal.

3. Plataformas de Terceiros: A escolha inteligente que lhe dá o poder de uma solução personalizada com a simplicidade de uma ferramenta que simplesmente funciona.

No final do dia, o seu objetivo é usar o conhecimento da sua empresa, não tornar-se um especialista em infraestrutura de IA. Para quase todas as empresas, construir uma "API de IA do Confluence" do zero é a decisão errada. O melhor caminho é escolher uma ferramenta que lhe dê o poder de que precisa sem toda a bagagem técnica.

Desbloqueie o seu conhecimento do Confluence hoje com uma API de IA do Confluence

Em vez de passar os próximos meses a lutar com APIs e bases de dados vetoriais, poderia ter um assistente de IA poderoso, treinado com os seus dados do Confluence e pronto a funcionar em minutos.

Veja como a eesel AI se pode conectar a todas as suas fontes de conhecimento e transformá-las num agente fiável e automatizado que funciona em todo o lado que você trabalha.

Comece o seu teste gratuito e veja como funciona por si mesmo.