> ## 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.

# Assistência de funcionário AI

> Executa um funcionário AI sobre a conversa sem atribuí-lo (assistência pontual)

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

`ai_assistance` **executa o funcionário AI que você escolher** sobre a conversa
**sem atribuí-lo**. É uma execução pontual: o funcionário roda de forma transitória
e gera sua assistência (contexto/sugestão) sobre a conversa, mas **não** se torna o
funcionário atribuído — a conversa continua com quem a atende (outro funcionário AI
ou um humano) e a atribuição não muda.

Como se diferencia das outras ações de AI:

* `run_ai` executa o funcionário **atribuído** —o que atende— e assume o turno.
* `assign_ai_employee` **muda** qual funcionário atende a conversa.
* `ai_assistance` **executa outro** funcionário **sem atribuí-lo** — sua saída não muda quem atende.

**Campos**

* `ai_employee` — `{ name }` do funcionário AI a consultar (obrigatório).
* `instructions` — texto opcional com a consulta ou o foco para o funcionário (por
  exemplo, "Este cliente se qualifica para o plano empresarial?").

```jsonc theme={null}
{
  "type": "ai_assistance",
  "ai_employee": { "name": "Especialista Legal" },
  "instructions": "O contrato permite cancelamento antecipado sem multa?"
}
```

Consome tokens do modelo do funcionário consultado e conta como ação que
dispara AI (máximo 3 por grupo). Em uma lista, este objeto vai no array
`actions` de um `POST /conversation/actions` — veja [Montar uma lista de
ações](/pt/action-groups/overview#montar-uma-lista-de-ações).

## Exemplo executável

Um `ai_assistance` em uma conversa identificada por telefone e canal: executa de
forma pontual o funcionário AI escolhido, sem mudar a atribuição da conversa.

### Request

```bash theme={null}
curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/actions" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": {
      "phone": "+5215512345678",
      "channel": "ch_7A9K2M4Q"
    },
    "actions": [
      {
        "type": "ai_assistance",
        "ai_employee": { "name": "Especialista Legal" },
        "instructions": "O contrato permite cancelamento antecipado sem multa?"
      }
    ]
  }'
```

### Resposta

`202 Accepted` — o grupo foi aceito e roda em **background**. O resultado por
ação não viaja na resposta (consulte-o depois — veja [Como é executado](/pt/action-groups/overview#como-é-executado)).

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

<ResponseField name="status" type="string">
  Sempre `processing`: confirma que o grupo foi aceito e está em execução.
</ResponseField>

<ResponseField name="actions_accepted" type="integer">
  Quantas ações do array foram **admitidas** para execução — não quantas tiveram
  sucesso.
</ResponseField>