Pular para o conteúdo
Acesso antecipado: o Ray vai responder com o conhecimento que cada empresa publicar. Solicitar acesso

Desenvolvedores

Configurar o Ray pelo terminal ou por um assistente próprio

Um arquivo de definição em JSON que o assistente de IA da empresa pode preencher e, mais adiante, uma CLI e um servidor MCP para automatizar o conhecimento, os testes e os relatórios. Sempre com as mesmas permissões e os mesmos casos de teste.

Acesso antecipado com acompanhamento da equipe. O Ray está em desenvolvimento.

Exemplo ilustrativo de um arquivo de definição de agente em JSON, no formato ray-agent/1, com nome interno, nomes de persona, tom Gentil, instruções, duas coleções de conhecimento e nenhuma ferramenta.

Exemplo ilustrativo com dados fictícios. Lumora é uma marca fictícia.

Status

O que está em desenvolvimento e o que vem depois

O arquivo de definição vai chegar com os agentes. A CLI e o servidor MCP vão usar chaves por empresa, que vão chegar depois do cofre de credenciais e de uma revisão de segurança. Sem datas prometidas.

  • Em desenvolvimento

    Arquivo de definição e briefing

    Importação e exportação de agentes em JSON, e um briefing para o assistente da empresa preencher.

  • Em breve

    CLI

    Envio de conhecimento, execução dos casos de teste, exportação de agentes e leitura de relatórios pelo terminal.

  • Em breve

    Servidor MCP

    O assistente da empresa vai consultar o Ray com uma chave própria: leitura por padrão, escrita só como proposta.

Arquivo de definiçãoEm desenvolvimento

O assistente da empresa vai montar o agente; o console vai validar

O console vai entregar um briefing para colar no assistente de IA da empresa. O assistente vai fazer uma entrevista curta e escrever o JSON; ao importar, vai ficar um agente em rascunho que passa pelos mesmos controles que um feito à mão.

  1. Copiar o briefing no console
  2. Colar no assistente da empresa e responder à entrevista
  3. Importar o JSON: vai ficar um agente em rascunho
  4. Testar e publicar, como qualquer mudançaQualquer agente vai poder ser exportado no mesmo formato.

Exemplo ilustrativo: em cima, o briefing de configuração com um botão para copiar; embaixo, o relatório de uma importação com os campos válidos, as coleções encontradas, nenhuma ferramenta atribuída e a publicação pendente, com botões para abrir o rascunho ou exportar como JSON.

Exemplo ilustrativo com dados fictícios. Lumora é uma marca fictícia.

CLIEm breve

O Ray pelo terminal

Para equipes que mantêm o conhecimento em arquivos ou querem rodar os testes no próprio processo de publicação. Vai ser instalada com pnpm e vai usar a chave da empresa.

  • Enviar conhecimento

    Uma pasta de arquivos md, txt ou html, como rascunhos ou novas versões para revisar.
  • Rodar os casos de teste

    O mesmo conjunto de casos do console, com o resultado por idioma.
  • Exportar agentes

    O mesmo JSON do arquivo de definição, para versionar junto com o resto.
  • Ler relatórios

    Lacunas de conteúdo e resoluções, em texto ou em JSON.

Exemplo ilustrativo de uma sessão no terminal: a instalação da CLI com pnpm, o login com a chave da empresa, o envio de uma pasta de ajuda que deixa rascunhos sem publicar, a execução dos casos de teste, a exportação de um agente em JSON e a leitura das lacunas de conteúdo.

Exemplo ilustrativo: os comandos podem mudar.

Servidor MCPEm breve

O assistente da empresa, conectado ao Ray

Um servidor MCP vai permitir que o assistente de IA da empresa, ou outro assistente compatível, trabalhe com o Ray usando uma chave própria. A leitura vai ser o padrão; a escrita, sempre uma proposta que uma pessoa aprova.

  • Somente leitura por padrão: busca no conhecimento e leitura de relatórios.
  • Cada escrita vai ser uma proposta, como um rascunho de artigo, que uma pessoa aprova.
  • A execução dos casos de teste nunca vai publicar nada.
  • Vai chegar depois do cofre de credenciais e da revisão de segurança.

Exemplo ilustrativo das ferramentas do servidor MCP: buscar no conhecimento e ler relatórios, somente leitura; propor um rascunho de artigo, como proposta; executar os casos de teste, sem publicar; e a chave ativa da empresa com papel Editor, que pode ser revogada.

Exemplo ilustrativo: os nomes das ferramentas podem mudar.

Segurança e controle

As mesmas regras pelo console, pelo terminal ou por um assistente

As chaves vão ser por empresa e por papel, cada ação vai ficar registrada e nenhuma mudança vai pular os casos de teste.

  • Chaves por empresa

    Cada chave vai pertencer a uma empresa e a um papel, e vai poder ser revogada a qualquer momento.

  • Exibidas uma única vez

    Depois de criada, a chave não vai voltar a aparecer completa: se for perdida, vai ser revogada e outra vai ser criada.

  • Registro de auditoria

    Cada ação vai ficar registrada com a chave, a pessoa que a criou e o resultado.

  • Os mesmos casos de teste

    Uma mudança que chegar pela CLI ou por MCP vai passar pelos mesmos casos e pelo mesmo piso de temas sensíveis.

Conversar sobre a configuração automatizada com a equipe do Ray

Uma conversa curta com a equipe que constrói o Ray para analisar o caso da empresa: consultas frequentes, conhecimento existente, temas sensíveis e plano de migração.