> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Artifacts: entregáveis com versão e controle de acesso

> Crie relatórios, dashboards e apresentações em HTML a partir do chat, com histórico de versões, compartilhamento controlado e governança para a empresa.

Artifacts transformam respostas do chat da Tess em entregáveis corporativos: relatórios executivos, dashboards, apresentações, comunicados e propostas em HTML. Cada Artifact tem um dono, um histórico de versões e um link estável, e o compartilhamento segue as políticas definidas pelo administrador da empresa.

> [!NOTE]
>
> O acesso ao recurso depende do plano contratado e do seu papel no workspace. Sem essa permissão, a Tess responde em texto e não gera o Artifact. Para liberar, fale com o administrador do workspace.

## Valor para a empresa

> [card] Uma fonte única por documento
>
> O entregável vive em um link estável. Atualizações geram novas versões no mesmo endereço, em vez de novos arquivos circulando por e-mail e chat.

> [card] Revisão antes da publicação
>
> Edições não chegam automaticamente a quem já recebeu o link. O público vê a versão aprovada até o dono compartilhar a próxima.

> [card] Compartilhamento governado
>
> O alcance de cada pessoa é definido pelo administrador, por membro e por equipe. Por padrão, nenhum conteúdo é aberto fora da organização.

> [card] Supervisão do workspace
>
> Gestores autorizados visualizam os Artifacts do workspace e podem despublicar qualquer um deles, inclusive em lote.

O resultado é menos retrabalho na produção de materiais recorrentes, menos versões desatualizadas em circulação e controle sobre o que cada público acessa.

## O que você pode criar

| Entregável | Exemplo | Áreas |
| - | - | - |
| Relatório executivo | Fechamento semanal de pipeline para a diretoria | Vendas, Diretoria |
| Dashboard | Indicadores do mês com filtro por equipe | Operações, Finanças |
| Apresentação | Resultados trimestrais para o conselho | Liderança, Estratégia |
| Comunicado interno | Anúncio de resultado ou de mudança de processo | RH, Comunicação |
| Proposta comercial | One-pager com escopo, prazo e próximos passos | Comercial, Customer Success |

Artifacts são páginas HTML visualizadas dentro da Tess. Quando o destino exige um arquivo, como PowerPoint, Word, PDF ou Excel, peça o formato explicitamente no chat: a Tess gera o arquivo separadamente.

## Controle de versão

* Cada edição ou restauração cria uma nova versão (v1, v2, v3...). Versões anteriores só deixam de existir se o dono as excluir, e os números nunca são reutilizados.
* O Artifact distingue a **versão mais recente**, em que o dono trabalha, da **versão compartilhada**, que o público vê.
* Para atualizar o que o público vê, o dono compartilha explicitamente a nova versão. O link continua o mesmo.
* Qualquer versão anterior pode ser visualizada, restaurada (gerando uma nova versão) ou definida como a versão compartilhada.

Na prática, um relatório pode ser corrigido e revisado enquanto a diretoria continua lendo a última versão aprovada.

## Quem acessa e o que pode fazer

| Perfil | O que vê | O que pode fazer |
| - | - | - |
| Dono | Todas as versões | Editar, ver o código, restaurar, compartilhar, excluir (com a permissão de exclusão de conteúdo), apresentar, baixar e imprimir |
| Pessoa, equipe ou workspace com acesso | Somente a versão compartilhada | Ler, apresentar, baixar o HTML, imprimir e iniciar um chat sobre o conteúdo. Não vê a aba Código, mas o HTML baixado contém a página inteira |
| Gestor com a permissão Artifacts Manager | A versão mais recente de qualquer Artifact do workspace, inclusive os não compartilhados, a partir de Configurações > Artefatos | Visualizar, apresentar, baixar, imprimir e despublicar. Não edita o conteúdo |
| Sem acesso | Nada | O Artifact não aparece para essa pessoa |

Somente o dono altera um Artifact. Quem precisa de uma variação pode pedir à Tess uma cópia própria, desde que também tenha permissão para criar Artifacts. O original permanece inalterado.

### Níveis de compartilhamento

* **Pessoas específicas** do workspace ou, quando o workspace pertence a uma organização, de outros workspaces dela
* **Equipes** das quais o dono participa
* **Todos neste workspace**
* **Qualquer pessoa com o link**, desde que autenticada na Tess, inclusive fora da organização

## Governança para administradores

> [accordion] Quem pode criar
>
> A criação, edição e compartilhamento de Artifacts são liberados por plano e por papel. Usuários sem essa permissão recebem a resposta em texto, sem gerar a página.

> [accordion] Com quem cada pessoa pode compartilhar
>
> Na página de membros, o administrador define por membro e por equipe quais níveis estão liberados: organização, workspace, equipes e link aberto. O padrão libera organização, workspace e equipes, e mantém o link aberto desativado. Uma configuração de membro sem níveis desativa o compartilhamento para aquela pessoa.

> [accordion] Restrições valem imediatamente
>
> Ao restringir os níveis de um membro ou de uma equipe, o acesso fora da nova regra é cortado na hora e os compartilhamentos correspondentes são revogados automaticamente. As permissões são verificadas a cada abertura: quem deixa o workspace perde o acesso na hora, exceto a Artifacts abertos a qualquer pessoa com o link.

> [accordion] Supervisão e despublicação
>
> Gestores com a permissão Artifacts Manager listam o conteúdo do workspace por pessoa, visualizam a versão mais recente de qualquer Artifact e despublicam um ou vários de uma vez. Despublicar remove todos os acessos. Quando a despublicação é feita por um gestor, o dono não pode compartilhar aquele Artifact novamente.

> [accordion] Exposição externa
>
> Mesmo o link aberto exige login na Tess. As páginas não são indexadas por buscadores e não podem ser incorporadas em outros sites.

> [accordion] Trilha de auditoria
>
> No plano Enterprise, os [Eventos de Auditoria](https://docs.tess.im/pt/audit-events.md) registram criação, edição, publicação, cada acesso concedido e revogado, visualizações e aberturas por gestores (uma por pessoa por dia em cada Artifact) e mudanças nas restrições de compartilhamento. O SIEM da empresa coleta os eventos pela API. Os eventos identificam quem fez a ação, mas não incluem o título do Artifact nem o e-mail de quem recebeu o acesso.

## Integração via API

Artifacts também estão disponíveis na API pública da Tess: criar, editar, renomear, listar e restaurar versões, publicar, despublicar, compartilhar e excluir, com as mesmas regras de dono, permissão e política de compartilhamento aplicadas no painel. Com isso, seus sistemas podem gerar e atualizar relatórios recorrentes sem passar pelo chat. Veja o [guia da API de Artifacts](https://docs.tess.im/pt/artifacts-api.md).

## Limites

> [!WARNING]
>
> Os dados de um Artifact são os que foram fornecidos na criação ou na edição. Dashboards não se conectam a sistemas em tempo real, e os scripts da página não acessam a internet. Para atualizar os números, peça a atualização no chat e compartilhe a nova versão.

Para publicar um site aberto na internet, use [Tess Pages](https://docs.tess.im/pt/tess-pages.md).

Para o passo a passo de criação e compartilhamento, veja [Criar e compartilhar](https://docs.tess.im/pt/usando-artifacts.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.