Pular para o conteúdo
Siglata Docs
Português
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Empresa

Dê ao agente o perfil, os produtos, a marca e as skills da empresa.

Cada organização tem um espaço da empresa, separado do drive. Ele guarda o que o agente precisa saber sobre a empresa: o perfil, os produtos, a marca e as skills. Os arquivos desse espaço nunca aparecem nas listagens do drive.

Tudo acontece pelo agente. Peça, por exemplo, “Configure a empresa na Siglata a partir do nosso site”, e ele cria o perfil e as pastas.

Organização do espaço

Caminho Conteúdo
empresa.md O perfil: campos principais no topo e o texto livre abaixo.
produtos/ Catálogos, fichas e tabelas de produtos.
marca/ Logotipos, cores, fontes e o manual da marca.
skills/<nome>/SKILL.md Uma skill da empresa, com os scripts dela na mesma pasta.

company_get devolve esse índice, com o id e o caminho de cada arquivo. As operações que listam ou criam arquivos recebem space: "company" para trabalhar nele (veja MCP).

O perfil

O perfil é o arquivo empresa.md. O topo, entre duas linhas ---, tem os campos principais em YAML; o texto abaixo descreve o que a empresa faz, o posicionamento, o tom e o público.

---
name: Café Aurora
site: https://cafeaurora.com.br
instagram: "@cafeaurora"
competitors: [Grão Nobre, Serra Alta]
markets: [São Paulo, Minas Gerais]
product_source: https://cafeaurora.com.br/produtos
---

Torrefação de cafés especiais em Uberaba. Tom próximo e direto.
Campo Conteúdo
name O nome da empresa. Obrigatório.
site O endereço do site, começando com https://.
instagram, linkedin, tiktok, youtube, x O perfil em cada rede.
competitors A lista de concorrentes.
markets A lista de mercados atendidos.
product_source De onde vêm os produtos: uma página ou um arquivo.

Um empresa.md com um campo inválido ou desconhecido é recusado, e a resposta nomeia cada campo a corrigir. Gravar de novo um arquivo com o mesmo nome na mesma pasta substitui o anterior, que vai para a lixeira.

Cada conexão do agente começa com o nome da empresa nas instruções do servidor, que indicam company_get para o perfil completo.

Skills da empresa

Uma skill da empresa é a pasta skills/<nome>/ com um SKILL.md e os scripts dela, como uma extração do Sankhya que toda a equipe usa. O topo do SKILL.md tem name (letras minúsculas, números e hífens) e description (quando usar a skill).

  • As instruções de cada conexão contam as skills e nomeiam as que cabem nos 2.048 caracteres que o Claude Code mantém.
  • skill_find com query busca, pelo nome e pela descrição, todas as skills que a conexão pode ler, sem abrir nenhum arquivo; com name, devolve o texto do SKILL.md da skill escolhida, que o agente lê antes da tarefa.
  • A skill company-skill do plugin salva as skills novas aqui. Uma skill pessoal é restricted e só quem a criou a vê; publicá-la para a organização exige a permissão de alterar o espaço.

Skills da Siglata

A Siglata publica skills próprias, como trabalhar com o drive, administrar membros, usar acessos a portais e escuta social. A empresa as instala em vez de escrevê-las:

  • Peça ao agente: skill_catalog lista as skills que a empresa pode instalar e skill_install instala a escolhida. Quando nenhuma skill instalada serve para uma tarefa, o agente sugere a do catálogo que serve.
  • Uma skill instalada segue sempre a versão mais recente da Siglata e não se edita. Para adaptá-la, skill_install com copy: true grava o texto atual como uma skill da empresa, que passa a valer no lugar da instalada.
  • Qualquer membro instala uma skill para si; uma instalação pessoal só aparece para quem a instalou e para quem recebe acesso com grant_set, como um arquivo. Instalar para a empresa toda exige a permissão de editar os dados da empresa.
  • Toda empresa começa com as skills de drive, administração e acessos a portais instaladas; escuta social e as demais são escolhas. Quem pode editar os dados da empresa remove uma instalação para todos; qualquer membro a esconde só para si.
  • Instalar é gratuito; uma skill paga gasta créditos nas operações dela.

O plugin da Siglata traz só a skill siglata, que leva cada tarefa ao skill_find, e a company-skill. As skills da Siglata chegam pela conexão, então uma versão nova vale sem atualizar o plugin.

Quem lê e quem altera

O espaço da empresa usa a mesma visibilidade e as mesmas permissões dos arquivos:

  • Todos os membros leem os itens visíveis para a organização.
  • Proprietários e administradores alteram o espaço.
  • “Editar dados da empresa” é uma permissão write na pasta raiz do espaço (o folderId de company_get), dada a um membro ou a um time com grant_set.
  • Um item restricted fica visível só para quem o criou e para quem recebeu acesso. Qualquer membro pode criar um item assim, como uma skill pessoal; torná-lo visível para a organização exige a permissão de alterar o espaço.

Esta página foi útil?