> ## Documentation Index
> Fetch the complete documentation index at: https://dev.docs.1to1ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asistencia de empleado AI

> Ejecuta un empleado AI sobre la conversación sin asignarlo (asistencia puntual)

<Info>
  **Endpoint** · `POST /conversation/actions`
</Info>

`ai_assistance` **ejecuta el empleado AI que elijas** sobre la conversación **sin
asignarlo**. Es una ejecución puntual: el empleado corre de forma transitoria y
genera su asistencia (contexto/sugerencia) sobre la conversación, pero **no** se
convierte en el empleado asignado — la conversación sigue con quien la atiende
(otro empleado AI o un humano) y la asignación no cambia.

Cómo se diferencia de las otras acciones de AI:

* `run_ai` ejecuta al empleado **asignado** —el que atiende— y toma el turno.
* `assign_ai_employee` **cambia** qué empleado atiende la conversación.
* `ai_assistance` **ejecuta** a **otro** empleado **sin asignarlo** — su salida no cambia quién atiende.

**Campos**

* `ai_employee` — `{ name }` del empleado AI a consultar (obligatorio).
* `instructions` — texto opcional con la consulta o el foco para el empleado (por
  ejemplo, "¿Este cliente califica para el plan empresarial?").

```jsonc theme={null}
{
  "type": "ai_assistance",
  "ai_employee": { "name": "Especialista Legal" },
  "instructions": "¿El contrato permite cancelación anticipada sin penalización?"
}
```

Consume tokens del modelo del empleado consultado y cuenta como acción que
dispara AI (máximo 3 por grupo). En una lista, este objeto va en el array
`actions` de un `POST /conversation/actions` — ver [Armar una lista de
acciones](/es/action-groups/overview#armar-una-lista-de-acciones).

## Ejemplo ejecutable

Un `ai_assistance` sobre una conversación identificada por teléfono y canal:
ejecuta de forma puntual al empleado AI elegido, sin cambiar la asignación de la
conversación.

### Request

```bash theme={null}
curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "ai_assistance",
        "ai_employee": { "name": "Especialista Legal" },
        "instructions": "¿El contrato permite cancelación anticipada sin penalización?"
      }
    ]
  }'
```

### Respuesta

`202 Accepted` — el grupo se aceptó y corre en **background**. El resultado real
por acción no viaja en la respuesta (se consulta después — ver [Cómo se ejecuta](/es/action-groups/overview#cómo-se-ejecuta)).

```json theme={null}
{
  "status": "processing",
  "actions_accepted": 1
}
```

<ResponseField name="status" type="string">
  Siempre `processing`: confirma que el grupo fue aceptado y está en ejecución.
</ResponseField>

<ResponseField name="actions_accepted" type="integer">
  Cuántas acciones del array se **admitieron** para ejecución — no cuántas
  tuvieron éxito.
</ResponseField>
