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

# Orquestração de IA e execução de fluxo de trabalho

> Entenda a execução do fluxo de trabalho, os registros de rastreamento MAIP, os resultados registrados e os limites de integração atuais.

Truthlocks possui duas interfaces de fluxo de trabalho distintas. Escolha a interface antes de construir uma integração; seus identificadores, payloads e comportamento de execução diferem.

| Interface | O que faz | Onde usar |
| - | - | - |
| Mecanismo de fluxo de trabalho do Console | Inicia um gráfico salvo por meio de um worker Temporal e registra suas etapas e resultados finais. | Designer de fluxo de trabalho do Console e histórico de execução. |
| APIs de orquestração e fluxo de trabalho MAIP | Armazenar definições, registros de rastreamento de execução e evidências de agente relacionadas. Essas rotas não iniciam o worker Temporal do Console. | Referências públicas `/v1/orchestrate/...`. |

## Execuções de fluxo de trabalho do Console

Salve o gráfico no designer de fluxo de trabalho, revise suas conexões e inicie-o com os dados de gatilho pretendidos. Uma resposta de lançamento bem-sucedida significa que o Temporal aceitou a solicitação; não significa que o trabalho foi concluído.

Abra **Histórico de execuções** e atualize o registo para inspecionar:

* `pending`: a solicitação é salva, mas o início do trabalhador ainda não foi registrado.
* `running`: o trabalhador registrou seu início.
* `completed`: as etapas selecionadas foram concluídas e o resultado final foi salvo.
* `failed`: uma etapa ou operação de fluxo de trabalho falhou. Inspecione as etapas registradas antes de tentar novamente os efeitos colaterais.
* `cancelled`: o cancelamento foi observado e o trabalhador salvou o resultado final.

Escolha **Configurações → Ambientes** antes de criar ou iniciar um fluxo de trabalho. A troca de ambientes não copia definições ou execuções. Um fluxo de trabalho de outro ambiente não pode ser lido, publicado, pausado ou iniciado através do ambiente atual. A seleção de produção ainda requer aprovação do espaço de trabalho.

Este limite de registro não simula provedores externos: uma etapa de IA ou e-mail suportada pode fazer uma solicitação real de provedor. Use entradas sintéticas e destinatários explicitamente autorizados durante os testes.

Novas execuções capturam o grafo salvo no lançamento. Edições posteriores não alteram essa execução. O resultado contém a versão da definição e o resumo SHA-256, identificadores de execução temporal, carimbos de data/hora, custos relatados pelas etapas e saída JSON da etapa. Execuções mais antigas podem não ter essas informações; elas não são reconstruídas ou fabricadas.

O executor rejeita ciclos e conexões inválidas. As etapas prontas são executadas na ordem de definição. Uma próxima etapa compartilhada aguarda seus predecessores e é executada uma vez quando pelo menos um caminho de entrada é selecionado. Uma ramificação escolhe uma condição exata antes de considerar sua conexão padrão.

Um resultado de execução é evidência operacional, não automaticamente um pacote de prova criptográfica. `proof_status: "not_generated"` significa explicitamente que nenhum pacote foi gerado. Um custo registrado zero não estabelece que um provedor externo não cobrou nada.

### Etapa de notificação por e-mail

Use um destinatário por etapa e forneça texto explícito:

```json theme={null}
{
  "id": "notify-reviewer",
  "name": "Notify reviewer",
  "type": "notify",
  "config": {
    "channel": "email",
    "recipients": ["reviewer@your-company.example"],
    "subject": "Your review is ready",
    "text_body": "Open your workspace to review the recorded result."
  }
}
```

O resultado relata `provider_accepted` e um identificador de mensagem depois que o provedor SMTP configurado aceita a mensagem. Não garante a entrega na caixa de entrada. Modelos nomeados, vários destinatários em uma etapa e canais não-e-mail não são suportados por esta atividade. As tentativas automáticas são desabilitadas porque o SMTP não pode garantir a entrega exata uma única vez. Investigue uma tentativa não confirmada antes de enviar novamente.

### Limites de execução a considerar

* Um tempo limite de lançamento pode deixar um registro `pending` mesmo que o Temporal tenha aceito a solicitação. Verifique essa execução antes de iniciar outra; a reconciliação automatizada de despacho permanece incompleta.
* As etapas de revisão humana do Console persistem as solicitações de aprovação atribuídas. As decisões autorizadas de aprovação/rejeição e seus resultados Temporais passaram na aceitação ao vivo. Um registro separado de aprovação de agente MAIP não sinaliza um fluxo de trabalho do Console.
* As etapas de IA usam o gateway Gemini configurado; uma execução sintética Temporal-para-Gemini passou na aceitação ao vivo. Valide seu próprio prompt, requisitos de saída e custos.
* As etapas externas `tool_call` não estão disponíveis no tempo de execução do conector implantado. Mantenha esses gráficos como rascunhos; eles não podem ser usados para automação de ferramentas de produção. Um pacote de integração externa não habilita um conector de fluxo de trabalho.
* Um worker em segundo plano reconcilia identificadores de execução Temporal conhecidos, incluindo falhas terminais e transições "continued-as-new". Ele não infere efeitos bem-sucedidos de histórico ausente e não consegue recuperar uma identidade de despacho desconhecida.
* As definições de fluxo de trabalho, execuções, etapas e aprovações criadas após o isolamento do ambiente são restritas ao ambiente de espaço de trabalho selecionado. Registros históricos sem atribuição de ambiente verificada permanecem disponíveis para supervisão da plataforma; eles não são silenciosamente atribuídos à produção. O isolamento mais amplo do lado do provedor e toda a recuperação de efeitos colaterais externos não são estabelecidos por este limite de armazenamento.
* Os eventos de auditoria de fluxo de trabalho são salvos com as mudanças de estado. Isso não estabelece a exportação concluída para todos os destinos de auditoria externos ou uma política de retenção certificada independentemente.

## Rastreamento de execução MAIP

A [referência de execução de orquestração](https://docs.truthlocks.com/pt/api-reference/machine-identity/orchestrations/execute.md) pública documenta `pattern`, `orchestrator_id` e `agent_ids`. Use seus campos gerados e menus suspensos para o contrato de solicitação completo.

Uma resposta HTTP `201` cria um registro de rastreamento. Seu status inicial `running` não é prova de que agentes ou ferramentas foram executados. Execute e supervisione essas ações em seu aplicativo até que um executor compatível seja conectado.

A [referência de execução de fluxo de trabalho MAIP](https://docs.truthlocks.com/pt/api-reference/machine-identity/workflows/execute.md) é uma rota separada de criação de registro que requer `trigger_agent_id`. Não substitua IDs de gráfico do Console nem presuma que um agendamento fornecido registra um agendamento Temporal.

Novos recibos MAIP gerados automaticamente usam o signatário gerenciado configurado. Verifique um recibo através da API de verificação de recibos. Sua assinatura autentica a declaração registrada; não prova que uma ação comercial não executada ocorreu. Alguns registros históricos preservados têm assinaturas de espaço reservado não verificáveis.

Para decisões humanas independentes sobre uma ação de agente proposta, use [aprovações de agente](https://docs.truthlocks.com/pt/guides/agent-approvals.md). Os registos de aprovação não executam ou retomam automaticamente um fluxo de trabalho.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.