Conceitos

Os termos que aparecem na API e no painel.

Conceito	O que é
Integração	Um sistema externo registrado pela empresa: nome, ambiente, permissões, agentes autorizados, aprovação e hora extra. Cada integração tem as suas chaves.
Agente	Um funcionário digital contratado pela empresa, identificado por `agt_…`. A integração só enxerga os agentes que a empresa autorizou.
Tarefa	Um pedido de trabalho para um agente (`tsk_…`). É assíncrona: você pede, acompanha o status e lê o resultado.
Aprovação	Opcional por integração. Ligada, cada tarefa espera alguém da empresa aprovar em Workforce › Aprovações.
Cota	Tarefas por mês incluídas no salário de cada agente, conforme o nível. Passou dela, só com hora extra liberada.
Webhook	Um endereço do seu sistema que recebe, assinado, cada mudança de status das tarefas.

O que o agente faz com o seu pedido

O input é o pedido em texto; o context são dados de apoio em JSON. Os dois vêm de fora e são tratados como informação, nunca como instrução: o agente segue as próprias regras, usa só os sistemas e as permissões que a empresa deu e chama uma pessoa quando a situação pede.

Mais do portal

Comece aqui: Visão geral · Primeiros passos

Guias: Autenticação · Conceitos · Tarefas e aprovações · Webhooks · Erros · Limites e cota · Ambiente de testes · MCP do Workforce

Referência: Referência da API · Exemplos de código · Versões e mudanças

Dados públicos: API pública do catálogo · MCP do catálogo público