Empresa

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

O espaço da empresa guarda o perfil, os produtos, a marca e as skills da empresa, separados do drive, e o agente lê esse espaço com company_get. Cada organização tem um, e os arquivos dele 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

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.

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 lista o nome e a descrição de todas as skills que a conexão pode ler, sem abrir nenhum arquivo, e o agente escolhe a que serve; com name, devolve o texto do SKILL.md da skill escolhida, que o agente lê antes da tarefa.
• A skill company-skill da Siglata 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_find lista também as skills que a empresa pode instalar, marcadas como não instaladas, 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, acessos a portais e criação de skills (company-skill) 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.

As skills da Siglata chegam pela conexão, então uma versão nova vale sem instalar nada no agente.

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.

Perguntas frequentes

Como preencho o perfil da empresa?

Peça ao agente, por exemplo “Configure a empresa na Siglata a partir do nosso site”. Ele grava o empresa.md e cria as pastas do espaço.

Quem pode alterar o perfil e as skills da empresa?

Proprietários, administradores e quem recebeu write na pasta raiz do espaço com grant_set. Todos os membros leem os itens visíveis para a organização.

Qual é a diferença entre uma skill da empresa e uma skill da Siglata?

A empresa escreve as próprias skills em skills/<nome>/. A Siglata publica as dela num catálogo: a empresa instala com skill_install, e a skill instalada segue sempre a versão mais recente.

Instalar uma skill da Siglata custa algo?

Não. Instalar é gratuito; uma skill paga gasta créditos nas operações dela.