Um primeiro fluxo de trabalho
Acrescente um mapa workflows ao agent.json. Cada chave dá nome a um fluxo de trabalho; cada valor tem um acionador e atividades.
{
"workflows": {
"morning-summary": {
"trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
"description": "Summarize yesterday's open conversations every weekday morning.",
"activities": [
{ "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
]
}
}
} Este fluxo de trabalho corre às 08:00 nos dias úteis, na hora local do bot. O funcionário realiza a atividade com a sua própria persona, skills e ligações.
Campos do fluxo de trabalho
| Campo | Significado |
|---|---|
trigger | Obrigatório. Quando o fluxo de trabalho corre. Consulte Acionadores. |
description | Para que serve o fluxo de trabalho. |
activities | Os passos. Consulte Atividades. |
connections | Arestas {from, to, label} que tornam as atividades um grafo. __trigger__ é o início e __emit__ o fim. |
emit | Eventos que este fluxo de trabalho anuncia quando termina: uma lista ou uma cadeia de texto separada por vírgulas. Consulte Eventos. |
inputs | Valores passados a todas as execuções. |
budget | {total_per_run, cost_estimate}. Numa execução em grafo, total_per_run limita os tokens de saída; caso contrário, ambos são estimativas. |
case | Faz do fluxo de trabalho um caso de longa duração por pessoa ou coisa. Consulte Casos. |
Um fluxo de trabalho com um acionador e sem atividades é válido. Um watch sem atividades apenas retransmite os seus eventos para outros fluxos de trabalho.
Como uma execução decorre
Sem connections, as atividades correm por ordem e o funcionário realiza cada uma. O resultado de cada atividade é passado à seguinte. Uma atividade sem saída termina a execução.
Com connections, as atividades formam um grafo. Os ramos correm em paralelo, e seis tipos de atividade correm sem o modelo: condition, loop, wait, http, command e decide. Use um grafo quando o encaminhamento tem de ser exato.
{
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"activities": [
{ "id": "classify", "type": "decide",
"params": {
"questions": {
"kind": {
"type": "choice",
"instructions": "What kind of message is this?",
"criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
}
},
"default": { "kind": "other" }
} },
{ "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
{ "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
],
"connections": [
{ "from": "__trigger__", "to": "classify" },
{ "from": "classify", "to": "is-invoice" },
{ "from": "is-invoice", "to": "record", "label": "True" },
{ "from": "record", "to": "__emit__" }
],
"emit": ["invoice.recorded"]
} O que uma execução recebe
O funcionário tem sempre a sua persona e as respostas do proprietário às perguntas de inputs. Uma execução recebe também estes valores, consoante o acionador.
| Entrada | Presente quando |
|---|---|
_event_source, _event_payload, _event_origin | Disparou um acionador de evento. Os payloads de 8 KB ou mais são reduzidos aos seus campos escalares, mantendo os cabeçalhos de email e as referências a anexos. |
_watch_payload | Disparou um acionador watch ou folder. Uma linha da saída do observador, ou {files} no caso de uma pasta. |
inputs | Sempre. Os valores de inputs do próprio fluxo de trabalho. |
Casos
Há trabalho que se estende por dias: um contacto comercial que precisa de seguimento, um pedido à espera de documentos. Acrescente case e o fluxo de trabalho mantém um caso aberto por pessoa ou coisa, em vez de recomeçar do zero de cada vez.
| Campo | Significado |
|---|---|
key | Obrigatório. Caminhos com pontos, separados por vírgulas, nos dados do acionador que identificam o sujeito, como contactEmail,email,phone. |
type | O tipo de caso, como lead. Os fluxos de trabalho com o mesmo tipo partilham casos. Por omissão, o nome do fluxo de trabalho. |
default_wait | Quanto tempo esperar quando um turno não indica espera: 3d, 12h, 45m. Por omissão, três dias. |
Cada turno de um caso tem de terminar com um objeto JSON e nada a seguir. result é o estado do negócio; next diz ao motor para fazer wait ou close. Um prazo é RFC 3339 ou um intervalo relativo. Qualquer outra coisa é um turno inválido.
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} Limites e recuperação
- Cada atividade pode usar até 50 turnos do modelo, a menos que
params.maxIterationsindique outra coisa. - Num grafo, uma atividade pode correr no máximo 10 000 vezes por execução.
- O limite de gastos que o proprietário definiu para o funcionário interrompe uma execução quando é atingido. O
token_budgetde uma atividade é uma estimativa. - Uma execução interrompida por um reinício é marcada como interrompida e retomada uma vez.
- O funcionário pode terminar uma execução mais cedo com a ferramenta
exit.
Executar e gerir fluxos de trabalho
O proprietário pode executar qualquer fluxo de trabalho manualmente. Os funcionários gerem fluxos de trabalho com run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled e as outras ferramentas de fluxos de trabalho indicadas em Ajudantes e equipas.