API de las bases de conocimiento

curl https://api.aidoo.ai/v1/knowledge/bases \
  -H "Authorization: Bearer aid_kb_tu_clave"

{
  "bases": [
    {
      "id": "6734c0f2a1b2c3d4e5f60718",
      "name": "Soporte",
      "description": "",
      "use_case": "support",
      "labels": [
        { "key": "product", "name": "Producto", "values": ["Contabilidad", "Nóminas"], "required": false }
      ],
      "entry_count": 412
    }
  ]
}

curl https://api.aidoo.ai/v1/knowledge/search \
  -H "Authorization: Bearer aid_kb_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"base": "6734c0f2a1b2c3d4e5f60718", "query": "error ERR-1045 en el cierre"}'

{
  "results": [
    {
      "entry_id": "6734c1aa...",
      "title": "Cierre del ejercicio",
      "url": "https://aide.exemple.com/cloture",
      "section": "Cierre del ejercicio > Errores frecuentes",
      "excerpt": "El mensaje ERR-1045 aparece cuando un diario todavía contiene asientos en borrador.",
      "score": 0.71,
      "exact_match": true,
      "labels": { "product": ["Contabilidad"] },
      "stale": false
    }
  ]
}

curl https://api.aidoo.ai/v1/knowledge/answers \
  -H "Authorization: Bearer aid_kb_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{
    "base": "6734c0f2a1b2c3d4e5f60718",
    "subject": "Cierre imposible",
    "body": "Hola, el cierre falla con el mensaje ERR-1045. ¿Qué hago?",
    "external_ref": "ticket-482:message-9051"
  }'

{
  "answer": {
    "id": "6734d2bb...",
    "base": "6734c0f2a1b2c3d4e5f60718",
    "action": "propose",
    "reason": "review_required",
    "body": "El mensaje ERR-1045 indica que un diario todavía contiene asientos en borrador. Valida esos asientos y vuelve a lanzar el cierre.",
    "body_html": "<p>El mensaje ERR-1045 indica que un diario todavía contiene asientos en borrador. Valida esos asientos y vuelve a lanzar el cierre.</p>",
    "confidence": 1,
    "checks": { "citations": true, "quotes": true, "links": true, "numbers": true, "grounded": 1 },
    "missing_info": [],
    "questions": [],
    "sources": [
      { "index": 1, "entry_id": "6734c1aa...", "title": "Cierre del ejercicio", "url": "https://aide.exemple.com/cloture", "section": "Errores frecuentes", "stale": false }
    ],
    "credits": 3,
    "outcome": null,
    "created_at": "2026-11-13T10:12:44.000Z"
  }
}

curl https://api.aidoo.ai/v1/knowledge/answers/6734d2bb.../outcome \
  -H "Authorization: Bearer aid_kb_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"outcome": "sent_edited", "final_body": "Hola, valida tus asientos en borrador y vuelve a lanzar el cierre."}'

curl "https://api.aidoo.ai/v1/knowledge/stats?base=6734c0f2a1b2c3d4e5f60718&days=30" \
  -H "Authorization: Bearer aid_kb_tu_clave"

from odoo import fields, models


class HelpdeskTicket(models.Model):
    _inherit = "helpdesk.ticket"

    aidoo_answer_id = fields.Char(copy=False)
    aidoo_answer_action = fields.Selection(
        [("propose", "Para revisar"), ("send", "Envío automático"),
         ("clarify", "Preguntas al cliente"), ("acknowledge", "Acuse de recibo"),
         ("none", "Nada que enviar")],
        copy=False,
    )
    aidoo_answer_body = fields.Html(copy=False, sanitize=True)
    aidoo_answer_sources = fields.Json(copy=False)
    aidoo_answer_pending = fields.Boolean(default=True, copy=False, index=True)

import requests

from odoo import api, models

API = "https://api.aidoo.ai/v1/knowledge"


class HelpdeskTicket(models.Model):
    _inherit = "helpdesk.ticket"

    @api.model
    def _cron_aidoo_answers(self, limit=20):
        params = self.env["ir.config_parameter"].sudo()
        key = params.get_param("aidoo_knowledge.api_key")
        base = params.get_param("aidoo_knowledge.base_id")
        if not key or not base:
            return
        for ticket in self.search([("aidoo_answer_pending", "=", True)], limit=limit):
            last = ticket.message_ids.filtered(lambda m: m.message_type == "email")[:1]
            payload = {
                "base": base,
                "subject": ticket.name or "",
                "body": ticket.description or "",
                "external_ref": f"ticket-{ticket.id}:message-{last.id or 0}",
            }
            try:
                response = requests.post(
                    f"{API}/answers",
                    json=payload,
                    headers={"Authorization": f"Bearer {key}"},
                    timeout=90,
                )
            except requests.RequestException:
                continue  # la próxima pasada lo reintentará
            if response.status_code == 402:
                break  # créditos agotados: no sirve de nada insistir
            if response.status_code in (409, 429, 503):
                continue  # ya en curso, o demasiadas llamadas: la próxima pasada lo reintentará
            if response.status_code != 201:
                ticket.aidoo_answer_pending = False
                continue
            answer = response.json()["answer"]
            ticket.write({
                "aidoo_answer_pending": False,
                "aidoo_answer_id": answer["id"],
                "aidoo_answer_action": answer["action"],
                "aidoo_answer_body": answer["body_html"],
                "aidoo_answer_sources": answer["sources"],
            })
            self.env.cr.commit()

    def action_aidoo_send(self):
        self.ensure_one()
        self.message_post(
            body=self.aidoo_answer_body,
            message_type="comment",
            subtype_xmlid="mail.mt_comment",
            partner_ids=self.partner_id.ids,
        )
        self._aidoo_outcome("sent_unchanged", final_body=self.aidoo_answer_body)

    def _aidoo_outcome(self, outcome, final_body=None, reason=None):
        params = self.env["ir.config_parameter"].sudo()
        key = params.get_param("aidoo_knowledge.api_key")
        if not key or not self.aidoo_answer_id:
            return
        payload = {"outcome": outcome}
        if final_body:
            payload["final_body"] = final_body
        if reason:
            payload["reason"] = reason
        try:
            requests.post(
                f"{API}/answers/{self.aidoo_answer_id}/outcome",
                json=payload,
                headers={"Authorization": f"Bearer {key}"},
                timeout=20,
            )
        except requests.RequestException:
            pass  # el resultado es un indicador, no debe bloquear el envío