Skip to main content

POST /v1/whatsapp/agents/{id}/knowledge

Aggiunge un documento alla conoscenza dell’agente: un testo con un titolo oppure una domanda frequente con la sua risposta. L’agente lo usa dal messaggio successivo. I file (PDF, Word…) si caricano solo dal pannello, in MyFlow → Agenti AI. Dall’API puoi mandare il loro contenuto come testo.

Parametri

Request Body

Un testo

Una domanda frequente

Le domande frequenti funzionano meglio dei testi lunghi: una domanda per documento, con la risposta che vuoi sentire dall’agente. Per un listino o un regolamento usa un testo, diviso per argomento in più documenti.
Limiti. Ogni agente ha al massimo 20 documenti e 200.000 caratteri in tutto: lo stato è in GET /v1/whatsapp/agents/{id}/knowledge. Il body di una richiesta non supera i 64 KB, quindi un testo molto lungo va diviso in più documenti.

Richiesta

Risposta

201 Created con il documento, nella forma di un documento.
Ogni aggiunta lascia una riga nel Log attività del pannello, con il titolo del documento.

Errori

404 - agent_not_found

Non c’è un agente con questo id su questo account.

422 - invalid_type

type manca o non è text o faq. Un file non si carica dall’API.

422 - invalid_title / invalid_text / invalid_question / invalid_answer

Campo mancante, vuoto o troppo lungo.

422 - unknown_fields

Un campo che non appartiene al tipo scelto: per text valgono title e text, per faq valgono question e answer.

409 - knowledge_limit

L’agente ha già 20 documenti, oppure con questo supererebbe i 200.000 caratteri. Il messaggio dice quale dei due. Togline qualcuno o accorcia i testi. Gli errori comuni a tutte le rotte sono nell’introduzione.