Agentes
Os agentes de IA que atendem pela organização.
| Operação | Endpoint |
|---|---|
| Alterar a saudação do agente principal | PATCH /agente/config |
Alterar a saudação do agente principal
PATCH/agente/config
Troca a saudação do agente principal da organização. A alteração fica na Auditoria. Escreva a saudação como o cliente deve ouvir ou ler: no telefone ela é falada como está escrita, sem passar pela IA.
Permissão exigida na chave: agentes:edit.
Corpo
| Campo | Tipo | Descrição |
|---|---|---|
greeting | texto | A nova saudação. Não pode ser vazia. |
Resposta 200
| Campo | Tipo | Descrição |
|---|---|---|
agent | objeto | |
agent.id | texto | Agente principal. |
agent.greeting | texto | A saudação gravada. |
Erros
| Status | Quando |
|---|---|
400 | invalid_json: O corpo da requisição não é um JSON válido. invalid_parameter: Parâmetro inválido. |
401 | unauthenticated: Não autenticado. invalid_credential: Credencial inválida. |
403 | insufficient_scope: Escopo insuficiente. |
409 | conflict: O estado atual do recurso não permite esta operação. |
429 | rate_limited: Limite de requisições atingido. Tente de novo depois do tempo indicado em Retry-After. |
500 | internal_error: Erro interno. Tente de novo; se persistir, fale com o suporte informando o X-Request-Id. |
O corpo segue o formato de Erros.
Exemplo
curl -X PATCH "https://app.conectaai.io/api/v1/agente/config" \
-H "Authorization: Bearer $CONECTAAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"greeting":"Olá! Sou a assistente virtual da Exemplo Net. Como posso ajudar?"}'Resposta 200:
{
"agent": {
"id": "8f0c2a4e-1b7d-4c55-9a1e-3d2f6b7c8a90",
"greeting": "texto"
}
}