Pular para o conteúdo
Guias · JUL 07 2026 · 6 min de leitura

Como compartilhar agentes de IA com seu time (sem expor as instruções)

Como compartilhar agentes de IA com o time sem expor instruções: os 4 níveis de permissão, papéis admin e usuário, marketplace da organização e governança.

Ilustração dos quatro níveis de compartilhamento de um agente de IA em progressão: privado com cadeado, pessoa específica com duas pessoas trocando um documento, organização com um grupo, e público com um globo e ícone de link, e o robô da Lumina conectado a todos por linhas pontilhadas.

Você pode compartilhar um agente de IA em 4 níveis: privado (só você), pessoa específica (com papel de admin ou de usuário), organização inteira (com review do owner) ou link público na web. O modelo é parecido com o Google Drive: quem é admin pode editar a instrução, quem é usuário só consome. Liberar pra empresa toda passa por aprovação.

compartilhando-agentes.png

Quem chega nesse assunto já criou um ou dois agentes e quer escalar pro time. Antes de sair compartilhando, vale entender os níveis e a governança, porque um agente bom espalhado do jeito errado vira dor de cabeça. Este guia é baseado em como o Pedro Lopes, diretor de produto da Alun Future Studio (Lumina), explicou o tema durante uma palestra. Se você ainda não criou o seu, comece pelo framework de 7 blocos .

Os 4 níveis de compartilhamento

O time da Lumina fez o benchmark com o Google Drive de propósito, pra você não precisar aprender um modelo novo. São quatro níveis, do mais fechado ao mais aberto.

Nível 1: privado. O agente fica só no seu marketplace pessoal. Ninguém mais vê nem usa. É onde todo agente nasce, enquanto você testa e ajusta.

Nível 2: pessoa específica. Você adiciona uma ou mais pessoas pelo nome e escolhe o papel de cada uma: administradora, que pode editar o conteúdo, ou usuária, que só pode usar. É o nível ideal pra um grupo pequeno de 2 a 5 pessoas, ou pra dividir a edição com um colega de confiança.

Nível 3: organização inteira. Você pode liberar o agente pro marketplace de toda a empresa, mas isso passa por review. O owner da organização olha e decide se aquele agente pode mesmo ficar aberto pra todo mundo. É o que garante que o catálogo interno não vire bagunça.

Nível 4: link público na web. Você marca o agente como público e manda o link pra quem tiver acesso à Lumina, mesmo de fora da sua organização. Serve pra colaboração entre empresas diferentes, mas exige cuidado redobrado com o que você expõe.

Admin vs usuário: as duas roles que importam

A distinção mais importante é entre quem edita e quem só usa. Como o Pedro coloca, as pessoas podem usar o meu agente, mas eu não quero que ninguém entre na instrução dele, porque a instrução pertence a mim.

O admin pode abrir e mudar a instrução, a fonte de conhecimento e os limites do agente. O usuário só conversa com ele e recebe respostas, sem ver como o agente foi montado. Essa separação existe por um motivo: a instrução é o trabalho. Você passou horas calibrando aqueles blocos, e não faz sentido qualquer pessoa poder alterá-los ou copiá-los. É o mesmo princípio pelo qual a Lumina não abre o prompt dos próprios agentes prontos. Dê papel de admin com parcimônia, só pra quem realmente precisa coeditar.

Marketplace interno: o que muda quando você libera pra organização

Quando você sobe um agente pro catálogo da empresa, ele fica visível pra todo mundo procurar e usar. Por isso existe o review do owner: alguém precisa olhar e aprovar antes. A ideia não é burocratizar, é curar.

O Pedro é claro sobre a filosofia por trás disso: a intenção não é ter um marketplace gigantesco com milhares de especialistas que ninguém consegue achar. Um catálogo pequeno e curado vale mais que um enorme e bagunçado. Quando você for propor um agente pro marketplace da organização, pense se ele resolve um problema real e recorrente pra muita gente. Se for útil só pra você, mantenha no nível 1 ou 2.

O link público é a ponte para pessoas que estão em empresas diferentes ou possuem contas individuais. Você marca o agente como público na web e envia o link pra pessoa, que precisa ter acesso à Lumina pra abrir. Use quando a colaboração cruza a fronteira da sua empresa. Não use pra nada que dependa de dados internos sensíveis, porque você perde parte do controle sobre quem vê o quê.

Como decidir o nível certo

A matriz abaixo resume a escolha por caso de uso.

Caso de usoNível recomendadoQuem precisa de admin
Agente experimental, em ajustePrivadoSó você
Agente para 2 a 5 pessoasPessoa específicaVocê e talvez um coeditor
Agente padronizado para uma áreaOrganização (com review)Você como dono da instrução
Colaboração com outra empresaLink públicoVocê, com cautela sobre dados

A regra geral: comece sempre no nível mais fechado e abra só quando o agente provar valor. É mais fácil ampliar o acesso depois do que recolher um agente mal calibrado que já se espalhou.

Erros comuns ao escalar agentes no time

Quatro armadilhas aparecem com frequência. A primeira é dar admin pra todo mundo "pra facilitar", o que abre a instrução pra alterações que você não controla. Dê papel de usuário por padrão. A segunda é não documentar a instrução fora da plataforma: se o agente é importante, guarde uma cópia versionada do prompt em algum lugar. A terceira é publicar antes de testar com casos reais. Um agente mal calibrado no marketplace não é só inútil, ele cria ruído em escala, pra muita gente ao mesmo tempo. A quarta é tratar o marketplace como vitrine, enchendo de agentes pra parecer avançado. Catálogo é contrato com o time, não enfeite.

Boas práticas de governança

Defina quem aprova o quê: o líder de área valida o conteúdo, o owner aprova a publicação org-wide. Se quiser um modelo mais formal por trás disso, frameworks de governança de IA como o NIST AI Risk Management Framework e o guia da IBM sobre governança de IA trazem os mesmos princípios em escala corporativa: papéis definidos, rastreabilidade e revisão contínua. Mantenha um registro simples do que mudou na instrução e por quê, pra não perder o histórico quando vários admins editam. Acompanhe a adoção real, porque estar no marketplace não significa que alguém usa. Vale espelhar o hábito do Pedro, que mantém agentes olhando bugs e feedbacks todo dia pra orientar melhorias. E revise o catálogo de tempos em tempos, aposentando o que ninguém usa. O guia de agentes de IA ajuda a manter o portfólio enxuto e útil.

Próximo passo: comece pelo privado, evolua devagar

Compartilhar agente bem é uma questão de disciplina: começar fechado, testar com poucos, abrir com critério e revisar sempre. Faça assim e o seu time ganha um catálogo confiável em vez de uma pilha de agentes esquecidos. Se ainda não tem o que compartilhar, o primeiro passo é criar: o framework de 7 blocos leva você do zero a uma primeira versão em menos de uma hora.

Perguntas frequentes

Posso compartilhar agentes entre organizações diferentes na Lumina?
Hoje o acesso direto entre organizações distintas (por exemplo, alguém da FIAP usando um agente criado na Alura) ainda não acontece automaticamente. O caminho atual é o link público na web: você marca o agente como público e envia o link pra quem tem acesso à Lumina. O Pedro indicou que melhorias nesse ponto estão em discussão, então vale checar a disponibilidade atual com o time antes de planejar uma operação que dependa disso.
Como vejo quais agentes estão sendo usados no meu time?
Plataformas corporativas costumam oferecer uma visão de adoção pra quem administra. O importante, mais que o número bruto, é olhar se os agentes do catálogo estão de fato resolvendo problemas. Acompanhe feedbacks e ajustes como rotina, do jeito que se faz com qualquer ferramenta interna. Confirme com o time da plataforma quais relatórios estão disponíveis na sua conta, porque isso evolui com frequência.
Quem é responsável se o agente disser algo errado?
Na prática, o admin dono da instrução. É quem definiu o contexto, as regras e os limites, então é quem responde pela calibragem. Por isso o papel de admin deve ser restrito e a publicação org-wide deve passar por review. Boa governança distribui essa responsabilidade de forma clara: líder de área valida o conteúdo, owner aprova a abertura pra todos, e ambos sabem que respondem pelo que está no catálogo.
Posso revogar o acesso de uma pessoa depois?
Pode. O compartilhamento funciona como o do Google Drive, então você adiciona e remove pessoas pela mesma interface, e também muda o papel de alguém de admin pra usuário ou o contrário. Se uma pessoa sai do time ou não precisa mais daquele agente, é só retirar o acesso. Vale revisar essas permissões de tempos em tempos, junto com a limpeza do catálogo.
Um agente já publicado pode ser alterado depois?
Sim. Quem tem papel de admin continua podendo editar a instrução, a fonte de conhecimento e os limites mesmo depois de o agente estar no marketplace. Isso é útil pra melhorar o agente com o tempo, mas pede cuidado: uma mudança mal pensada afeta todo mundo que usa. A boa prática é registrar o que mudou e, em agentes muito usados, testar o ajuste antes de aplicar pra toda a organização.
Lumina Editorial

Não perca um post

Te avisamos quando publicar um post novo. Sem spam, cancele a hora que quiser. Cerca de um email a cada duas semanas.