Saltar para o conteúdo
Falnoa

Documentação

Ligue um agente.Em cinco minutos.

Uma chave, uma chamada, ligado.

Fale connosco

1. Crie uma chave

Abra o agente no Blue Falnoa, depois Definições, depois Ligar em 5 minutos (administrador). Crie uma chave de ingestão. É mostrada uma só vez e guardada apenas como hash. Rodá-la revoga logo a chave anterior.

Envie-a como Authorization: Bearer bfa_… em todas as chamadas.

2. Envie uma mensagem

A primeira chamada cria a conversa e as seguintes acrescentam. Mensagens com id são seguras de repetir: uma já guardada é ignorada.

curl -X POST https://YOUR-INSTANCE/api/agent/v1/conversations/order-123/messages \
  -H "Authorization: Bearer bfa_…" \
  -H "Content-Type: application/json" \
  -d '{"messages": [
        {"id": "m1", "role": "user", "content": "Where is my order?"},
        {"id": "m2", "role": "assistant", "content": "It ships tomorrow."}
      ]}'

A mesma página oferece excertos prontos para curl, Python, TypeScript, OpenAI, LangChain e n8n, e repara sozinha na primeira mensagem.

3. Se nada chegar, corra o doctor

O doctor diz se a chave está errada ou foi rodada (401), se o agente não está aprovado no registo ou se o orçamento mensal foi atingido. Quando a chave é válida mas a primeira mensagem seria recusada, ok é falso e problems diz porquê.

python -m blue_falnoa doctor https://YOUR-INSTANCE bfa_…
# or: curl -H "Authorization: Bearer bfa_…" https://YOUR-INSTANCE/api/agent/v1/ping

O que acontece a seguir

Revisão

As mensagens do assistente aparecem em Conversas, onde as pessoas podem verificar uma resposta.

Custo

Junte usage a uma mensagem e os tokens e o custo aparecem por agente. Sem isso, só tokens.

Dados pessoais

Emails, IBAN, NIF e números de cartão são assinalados ou mascarados antes de guardar, conforme o administrador escolheu.

Todos os guias

API de agentes

Conversas, pesquisa de conhecimento, o doctor e passos A2A.

Gateway de ações

request_approval: pagar, enviar ou apagar só depois de uma pessoa aprovar.

SDK e adaptadores

Clientes Python e TypeScript, adaptadores OpenAI e LangChain, e n8n.

Verificação offline

Verifique um pacote de evidência offline com o bf-verify, ou no browser.

Documentação