Documentos, arquivos e skills | Basement Gateway

Documentos

Um documento é uma página em markdown: seu perfil de cliente ideal, suas regras de preço, um processo. Os documentos pertencem à organização, e todos os membros veem.

Cada alteração em um documento cria uma nova versão. Você pode listar as versões e restaurar uma delas. O Basement registra qual versão cada agente leu, e assim você vê quando um agente está trabalhando com uma versão desatualizada.

Para fazer isto	Use
Listar e ler	`list_docs`, `read_doc`
Criar	`create_doc`
Substituir o corpo	`update_doc`
Alterar um trecho do texto	`edit_doc`
Renomear, excluir	`rename_doc`, `delete_doc`
Ver e restaurar versões	`list_doc_versions`, `restore_doc_version`
Ligar ou desligar o link público	`share_doc`

Um documento com link público pode ser lido por qualquer pessoa que tenha o link, sem login. O link entrega o documento como página para pessoas e como markdown para agentes.

Arquivos

Um arquivo é qualquer coisa que você envia: um PDF, um logo, uma planilha, um arquivo de texto. Pelo Gateway, é possível gravar arquivos de até 5 MB. Substituir um arquivo cria uma nova versão.

read_file responde os dados do arquivo e um link temporário para baixar. Para um arquivo de texto de até 256 KB, responde também o texto.

Para fazer isto	Use
Listar e ler	`list_files`, `read_file`
Enviar um arquivo, ou uma nova versão	`write_file`
Alterar um trecho de um arquivo de texto	`edit_file`

Skills

Uma skill é um arquivo de texto com instruções que um agente carrega quando precisa: como pesquisar uma conta, como responder um tipo de chamado. Skills são arquivos de um tipo próprio.

Para fazer isto	Use
Listar	`list_skills`
Ler	`read_file`
Criar, ou gravar uma nova versão	`write_skill`
Alterar um trecho	`edit_skill`

Pastas

Arquivos e skills ficam em pastas. Todos os membros veem a pasta Geral. Uma pessoa pode criar outras pastas, que são privadas até ela compartilhar com membros ou com a organização.

Uma chave alcança as pastas que a pessoa que conectou a chave alcança, e um nível de acesso pode limitar a chave a algumas delas. Um arquivo em uma pasta que a chave não pode usar aparece como não encontrado.

Para fazer isto	Use
Listar as pastas que a chave pode usar	`list_folders`
Criar uma pasta privada	`create_folder`
Colocar um arquivo ou uma skill nova em uma pasta	`folderId` em `write_file` e `write_skill`
Compartilhar uma pasta	`share_folder` e depois `confirm_folder_share`

Uma chave não compartilha uma pasta sozinha. share_folder só faz o pedido: o Basement envia por e-mail um código de 6 dígitos para a pessoa que conectou a chave, e nada é compartilhado até confirm_folder_share receber esse código. Assim, uma pessoa sempre aprova o compartilhamento.

Encontrar texto sem ler tudo

Três ferramentas evitam que um agente carregue um documento grande só para achar uma linha:

search encontra documentos por título e corpo, e arquivos e skills por nome e tags.
find_text encontra uma frase dentro de um documento ou arquivo de texto, e responde as linhas que batem, com os números delas.
read_lines lê um intervalo de linhas.

Para alterar um documento, uma skill ou um arquivo de texto, edit_doc, edit_skill e edit_file substituem um trecho do texto. Informe o texto antigo exatamente como está. Ele precisa aparecer uma única vez.