Saltar para o conteúdo
Falnoa

Documentação

Instalar. Ligar.Confiar.

Instalar, ligar, proteger.

Fale connosco

Instalar

Cada instalação do Blue Falnoa serve um cliente. Precisa de um servidor Linux com Docker, de um nome DNS, e da versão e da chave de licença que lhe enviamos.

  1. 1

    Copie para o servidor o kit de instalação que enviamos com cada versão.

  2. 2

    Corra o instalador com a versão, o domínio e o email do administrador. O HTTPS é automático.

  3. 3

    Inicie sessão, abra Definições, Licença, e cole a chave que lhe devolvemos. Até lá a aplicação fica só de leitura.

sudo ./install.sh --version <version> \
  --domain blue.example.com \
  --admin-email [email protected]

A operação diária usa o comando bf: estado, registos, cópia de segurança, restauro e atualização, com reversão automática se a atualização ficar instável. Atrás do seu próprio proxy, ou sem internet, há opções para ambos.

API e SDKs

Os agentes enviam as conversas com uma chave de ingestão criada nas definições do agente. As mensagens com id podem ser reenviadas sem risco.

POST /api/agent/v1/conversations/{id}/messages
Authorization: Bearer bfa_…

{ "messages": [
  { "id": "m1", "role": "user", "content": "Where is my order?" },
  { "id": "m2", "role": "assistant", "content": "It ships tomorrow." }
] }

Conversas

Envie até 500 mensagens por chamada, com consumo de tokens e custo opcionais.

Conhecimento

Os agentes pesquisam o conhecimento publicado pela mesma API.

Fluxos de trabalho

Agentes que falam o protocolo A2A executam passos e respondem.

Tokens

Tokens com âmbito, validade e revogáveis para a sua automação.

Clientes oficiais para TypeScript e Python, sem dependências de execução.

import { AgentClient } from "@blue-falnoa/sdk";

await new AgentClient(url, "bfa_…").sendMessages("c1", [
  { id: "m1", role: "user", content: "Hello" },
]);

Segurança

Uma vista curta dos controlos que existem hoje. A lista completa, com o que está verificado e o que não está, encontra-se na página de confiança.

Acesso

Papéis de administrador, operador e leitor, aplicados no servidor.

Início de sessão

Aplicação de autenticação, códigos de recuperação, passkeys e OpenID Connect.

Segredos

Palavras-passe, sessões e chaves de API ficam guardadas em hash; as credenciais são cifradas.

Auditoria

Registo de auditoria encadeado por hash, que pode verificar e exportar.

Isolamento

Uma instância por cliente, num contentor restrito.

Falha segura

Em produção recusa arrancar com uma configuração insegura.

Encontrou uma vulnerabilidade? Comunique-a em privado por email. Não abra um pedido público. hello@falnoa.com

Ver a página de confiança

Precisa dosguias completos?

Peça e enviamos.

Fale connosco