Estrutura e tarefas

Workspaces, atividades e tarefas — a árvore que organiza o que o agente faz —, o disparo de uma tarefa, a pré-checagem e o endpoint HTTP de disparo.

Famílias nesta página

Família	Tools	read	write	destructive
workspaces — Workspaces	5	2	2	1
activities — Atividades	5	2	2	1
tasks — Tarefas	10	4	2	4

workspaces

Tool	Tipo	Escopo	Permissão	Endpoint	O que faz
kadu_workspaces_list	read	kadu/workspaces + read	agent.workspaces.list	GET /v1/workspaces	Lists the workspaces of the organization (the top level of Workspace > Activity > Task).
kadu_workspaces_get	read	kadu/workspaces + read	agent.workspaces.read	GET /v1/workspaces/{id}	Gets a workspace.
kadu_workspaces_create	write	kadu/workspaces + write	agent.workspaces.create	POST /v1/workspaces	Creates a workspace.
kadu_workspaces_update	write	kadu/workspaces + write	agent.workspaces.update	PATCH /v1/workspaces/{id}	Updates a workspace.
kadu_workspaces_delete	destructive	kadu/workspaces + delete	agent.workspaces.delete	DELETE /v1/workspaces/{id}	Deletes a workspace together with its activities and tasks.

activities

Tool	Tipo	Escopo	Permissão	Endpoint	O que faz
kadu_activities_list	read	kadu/activities + read	agent.activities.list	GET /v1/activities	Lists the activities (groups of tasks inside a workspace).
kadu_activities_get	read	kadu/activities + read	agent.activities.read	GET /v1/activities/{id}	Gets an activity.
kadu_activities_create	write	kadu/activities + write	agent.activities.create	POST /v1/activities	Creates an activity inside a workspace.
kadu_activities_update	write	kadu/activities + write	agent.activities.update	PATCH /v1/activities/{id}	Updates an activity.
kadu_activities_delete	destructive	kadu/activities + delete	agent.activities.delete	DELETE /v1/activities/{id}	Deletes an activity together with its tasks.

tasks

Tool	Tipo	Escopo	Permissão	Endpoint	O que faz
kadu_tasks_list	read	kadu/tasks + read	agent.tasks.list	GET /v1/tasks	Lists the tasks: each one runs a skill (<plugin>:<skill>) of the organization repository as the agent.
kadu_tasks_get	read	kadu/tasks + read	agent.tasks.read	GET /v1/tasks/{id}	Gets a task, with its parameters schema and whether it is conversational.
kadu_tasks_create	write	kadu/tasks + write	agent.tasks.create	POST /v1/tasks	Creates a task that runs a skill of the organization repository.
kadu_tasks_update	write	kadu/tasks + write	agent.tasks.update	PATCH /v1/tasks/{id}	Updates a task.
kadu_tasks_delete	destructive	kadu/tasks + delete	agent.tasks.delete	DELETE /v1/tasks/{id}	Deletes a task.
kadu_tasks_run	destructive	kadu/tasks + write	agent.executions.run	POST /v1/tasks/{id}/run	Runs a task: queues an execution of the financial agent in an environment.
kadu_tasks_readiness_get	read	kadu/tasks + read	agent.tasks.read	GET /v1/tasks/{id}/readiness	Pre-check of a run: whether the task can be run now in the environment (plan, cost limit, missing secrets, repository).
kadu_tasks_endpoint_get	read	kadu/tasks + read	agent.tasks.read	GET /v1/tasks/{id}/endpoint	Gets the task's HTTP trigger endpoint: URL, whether it is enabled and the auth type (credentials are never returned).
kadu_tasks_endpoint_update	destructive	kadu/tasks + write	agent.tasks.update	PUT /v1/tasks/{id}/endpoint	Configures the HTTP endpoint that lets a third party trigger the task, with its credentials.
kadu_tasks_endpoint_delete	destructive	kadu/tasks + delete	agent.tasks.update	DELETE /v1/tasks/{id}/endpoint	Disables the task's HTTP trigger endpoint (the configuration is kept).

---

Os campos de cada recurso estão na referência da API.

Uma tool que você não pode rodar não aparece em tools/list. Se uma daqui não está lá, veja Autenticação.