> Os agentes de IA que atendem pela organização. Referência gerada do contrato da API. # Agentes {/* Gerado por scripts/gerar-referencia.mjs a partir de openapi/openapi.json. Não edite: rode `pnpm referencia`. */} # Agentes Os agentes de IA que atendem pela organização. | Operação | Endpoint | |---|---| | [Alterar a saudação do agente principal](#alterar-a-saudação-do-agente-principal) | `PATCH /agente/config` | ## Alterar a saudação do agente principal 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](/erros). ### Exemplo ```bash 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`: ```json { "agent": { "id": "8f0c2a4e-1b7d-4c55-9a1e-3d2f6b7c8a90", "greeting": "texto" } } ```