Símbolo da AmivuSímbolo da AmivuDevelopers

A Ami

O que a IA sabe da empresa, os papéis dela e o acervo de perguntas e respostas.

A Ami é a IA que atende na Amivu: responde o cliente, sugere respostas à equipe, classifica e etiqueta conversas. Pela API você configura o que ela sabe e como ela age, em três partes: a configuração da conta, os papéis e o acervo de perguntas e respostas.

A configuração

GET /v1/ami/settings devolve uma configuração por organização, sem id. PATCH muda só o que vier, com ami:write.

Terminal
curl -X PATCH https://api.amivu.com.br/v1/ami/settings \
  -H "Authorization: Bearer $AMIVU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "context": "Barbearia no centro de Sorocaba. Corte a R$ 50, de terça a sábado, das 9h às 19h.",
    "auto_reply_enabled": true
  }'
Resposta
{
  "object": "ami_settings",
  "auto_reply_enabled": true,
  "context": "Barbearia no centro de Sorocaba. Corte a R$ 50, de terça a sábado, das 9h às 19h.",
  "orchestration": "auto",
  "default_role_id": null,
  "learning_enabled": true,
  "features": {
    "ami": true,
    "chat": true,
    "suggestions": true,
    "classification": true,
    "insights": true,
    "auto_tags": true,
    "customer_summary": true,
    "risk_detection": true
  }
}
  • auto_reply_enabled liga a Ami respondendo sozinha. Ela responde nos canais em que ami_auto_reply está ligado (ver Canais).
  • context é o que ela sabe da empresa, até 8000 caracteres; null apaga.
  • orchestration: auto escolhe o papel pela conversa; fixed usa sempre default_role_id.
  • learning_enabled: ela tira perguntas e respostas das conversas para o acervo, onde esperam revisão.
  • features liga e desliga cada recurso; o que não vier fica como está.

Papéis

Um papel é um jeito de atender, com instruções próprias: vendas, suporte, cobrança. when_to_use é o que a Ami lê para escolher o papel de cada conversa.

Terminal
curl https://api.amivu.com.br/v1/ami/roles \
  -H "Authorization: Bearer $AMIVU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Agendamento",
    "when_to_use": "Quando o cliente quer marcar, remarcar ou cancelar um horário.",
    "instructions": "Ofereça os horários livres da semana e confirme o nome e o serviço."
  }'

PATCH /v1/ami/roles/{role_id} muda o que vier e DELETE apaga. Os ids são amr_….

O acervo

O acervo são perguntas e respostas que a Ami usa ao responder. O que você escreve por POST /v1/ami/knowledge já nasce aprovado e passa a valer. O que ela aprende nas conversas chega como pending, com origin: "learned", e só vale depois de revisado.

Terminal
curl "https://api.amivu.com.br/v1/ami/knowledge?status=pending" \
  -H "Authorization: Bearer $AMIVU_API_KEY"
Terminal
curl -X PATCH https://api.amivu.com.br/v1/ami/knowledge/amk_01K7ZFA5X8Q2M4N6P8R0T2V4W6 \
  -H "Authorization: Bearer $AMIVU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "approved" }'

approved passa a valer; rejected deixa de valer. O mesmo PATCH corrige question e answer.

Só com a chave de produção

A configuração da Ami não tem sandbox
Ela é uma só para a organização e vale para os clientes de verdade. A chave de sandbox lê (ami:read), mas mudar volta 403 live_key_required.

O que a API não faz

  • Escolher o modelo de linguagem. Ele depende do plano e do crédito da conta, e muda no painel.
  • Memórias por contato. O que a Ami lembra de cada cliente fica no painel.

Veja também Automações e Servidor MCP.

Escrevemos sobre operação de atendimento, canais e IA no blog da Amivu.