Conversas
Envie até 500 mensagens por chamada, com consumo de tokens e custo opcionais.
Documentação
O essencial para começar.O essencial para pôr o Blue Falnoa a funcionar, ligar os agentes e rever o modelo de segurança. Os guias completos vêm com a licença.
Fale connoscoGuias para quem integra · v0.1.0-rc.4
Crie uma chave, envie uma mensagem e veja o agente ligado.
Conversas, pesquisa de conhecimento, o doctor e passos A2A.
request_approval: pagar, enviar ou apagar só depois de uma pessoa aprovar.
Clientes Python e TypeScript, adaptadores OpenAI e LangChain, e n8n.
Verifique um pacote de evidência offline com o bf-verify, ou no browser.
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
Copie para o servidor o kit de instalação que enviamos com cada versão.
2
Corra o instalador com a versão, o domínio e o email do administrador. O HTTPS é automático.
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 you@example.comA 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." }
] }Envie até 500 mensagens por chamada, com consumo de tokens e custo opcionais.
Os agentes pesquisam o conhecimento publicado pela mesma API.
Agentes que falam o protocolo A2A executam passos e respondem.
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.
Papéis de administrador, operador e leitor, aplicados no servidor.
Aplicação de autenticação, códigos de recuperação, passkeys e OpenID Connect.
Palavras-passe, sessões e chaves de API ficam guardadas em hash; as credenciais são cifradas.
Registo de auditoria encadeado por hash, que pode verificar e exportar.
Uma instância por cliente, num contentor restrito.
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çaPeça e enviamos.Os clientes licenciados recebem os guias de instalação, operação e segurança. Peça-nos e enviamos o que precisar.
Fale connosco