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.
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
}'
{
"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_enabledliga a Ami respondendo sozinha. Ela responde nos canais em queami_auto_replyestá ligado (ver Canais).contexté o que ela sabe da empresa, até 8000 caracteres;nullapaga.orchestration:autoescolhe o papel pela conversa;fixedusa sempredefault_role_id.learning_enabled: ela tira perguntas e respostas das conversas para o acervo, onde esperam revisão.featuresliga 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.
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.
curl "https://api.amivu.com.br/v1/ami/knowledge?status=pending" \
-H "Authorization: Bearer $AMIVU_API_KEY"
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
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.