Um primeiro fluxo de trabalho
Adicione um mapa workflows ao agent.json. Cada chave dá nome a um fluxo de trabalho; cada valor tem um gatilho 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 roda às 08:00 nos dias úteis, no horário local do bot. O funcionário realiza a atividade com a própria persona, as próprias skills e as próprias conexões.
Campos do fluxo de trabalho
| Campo | Significado |
|---|---|
trigger | Obrigatório. Quando o fluxo de trabalho roda. Veja Gatilhos. |
description | Para que serve o fluxo de trabalho. |
activities | As etapas. Veja Atividades. |
connections | Arestas {from, to, label} que transformam as atividades em um grafo. __trigger__ é o início e __emit__, o fim. |
emit | Eventos que este fluxo de trabalho anuncia ao terminar: uma lista ou uma única string separada por vírgulas. Veja Eventos. |
inputs | Valores passados para toda execução. |
budget | {total_per_run, cost_estimate}. Em uma execução em grafo, total_per_run limita os tokens de saída; nos outros casos, ambos são estimativas. |
case | Transforma o fluxo de trabalho em um caso de longa duração por pessoa ou coisa. Veja Casos. |
Um fluxo de trabalho com um gatilho e sem atividades é válido. Um watch sem atividades apenas repassa os eventos dele para outros fluxos de trabalho.
Como uma execução acontece
Sem connections, as atividades rodam em ordem e o funcionário realiza cada uma. O resultado de cada atividade é passado para a próxima. Uma atividade sem saída encerra a execução.
Com connections, as atividades formam um grafo. Os ramos rodam em paralelo, e seis tipos de atividade rodam sem o modelo: condition, loop, wait, http, command e decide. Use um grafo quando o roteamento precisar 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 sempre tem a própria persona e as respostas do proprietário às perguntas de inputs dele. Uma execução também recebe estes valores, dependendo do gatilho.
| Entrada | Presente quando |
|---|---|
_event_source, _event_payload, _event_origin | Um gatilho event disparou. Payloads de 8 KB ou mais são encurtados para os campos escalares, mantendo os cabeçalhos de e-mail e as referências a anexos. |
_watch_payload | Um gatilho watch ou folder disparou. Uma linha da saída do observador, ou {files} para uma pasta. |
inputs | Sempre. Os valores de inputs do próprio fluxo de trabalho. |
Casos
Alguns trabalhos se estendem por dias: um lead que precisa de acompanhamento, um pedido aguardando documentos. Adicione case e o fluxo de trabalho mantém um caso aberto por pessoa ou coisa, em vez de começar do zero a cada vez.
| Campo | Significado |
|---|---|
key | Obrigatório. Caminhos com pontos, separados por vírgulas, nos dados do gatilho que identificam o assunto, como contactEmail,email,phone. |
type | O tipo de caso, como lead. Fluxos de trabalho com o mesmo tipo compartilham casos. O padrão é o nome do fluxo de trabalho. |
default_wait | Quanto esperar quando um turno não informa uma espera: 3d, 12h, 45m. Padrão de três dias. |
Cada turno de um caso precisa terminar com um objeto JSON e nada depois dele. result é o estado do negócio; next diz ao motor para 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.maxIterationsdiga outra coisa. - Em um grafo, uma atividade pode rodar 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 uma reinicialização é marcada como interrompida e retomada uma vez.
- O funcionário pode encerrar uma execução antes com a ferramenta
exit.
Executar e gerenciar fluxos de trabalho
O proprietário pode executar qualquer fluxo de trabalho manualmente. Os funcionários gerenciam fluxos de trabalho com run_workflow, workflow_status, list_workflow_runs, set_workflow_enabled e as outras ferramentas de fluxo de trabalho listadas em Ajudantes e equipes.