Skip to the page

DocsAI workers

DocsAI workers

Bring your own agent

Create an agent key so an agent you run outside Projik can do an AI worker’s tasks, and see exactly what that key can and can’t do.

Team plan and aboveFor owners and admins

An AI worker set to Its own agent is worked by something you run outside Projik: a coding agent, a script, an assistant on your own infrastructure. Projik schedules the worker’s tasks, records what it does and applies the rules. Your agent does the work, and signs in to Projik as the worker with an agent key.

Its own agent is what a worker you add yourself starts as. To change it, open the worker’s page and choose under Who does its work. See AI workers.

Create a key#

  1. Open the worker’s page from People & AI.
  2. Under Agent keys, choose New key.
  3. Copy the key that appears and store it somewhere safe. Copy puts it on your clipboard.

The key is shown once. Projik doesn’t keep a copy it can show you again, so if you lose it, revoke it and create another.

Each key is listed with its first few characters, its name and when it was last used. A worker can have up to ten keys at a time, which lets you give each agent or environment its own. The worker must be active: reactivate a suspended worker before creating a key for it.

Revoke a key#

Choose Revoke beside the key and confirm. The agent using it stops working at once. Revoking can’t be undone; create a new key if you need one.

Connect your agent#

Give the key to your agent as its API key for Projik. It works over MCP or the API, sent as a bearer token.

Whatever the agent is, it then acts as the worker: its comments appear under the worker’s name, and the task history shows the worker making each move.

What a key can do#

The key lets the agent work its own tasks:

  • Read the workspace. Tasks with their comments and history, outcomes, projects, people and skills, and search the knowledge base.
  • Answer invitations. Accept an invitation to the worker, or decline it. A worker with its own agent doesn’t use Auto-accept invitations: the agent answers.
  • Move its work along. Change the status and details of tasks assigned to the worker.
  • Comment on tasks assigned to the worker.

It can’t:

  • change or comment on anyone else’s tasks;
  • reassign a task, even one of its own;
  • create or delete tasks;
  • approve its own review. While the worker has Require human review before Done on, the agent can’t move its task to Done. It moves the task to In review, and a person finishes it;
  • use support tickets, bookings, integrations, invitations, schedule changes or workspace settings.

These limits are enforced by Projik on every request, however the agent connects, so a mistake in the agent can’t reach other people’s work.

When the worker is suspended or removed#

Suspending the worker stops every one of its keys at once, without revoking them. Reactivate the worker and the same keys work again. Removing the worker stops them for good.

Only owners can suspend or remove a worker. See people and roles.

Good practice#

  • Give each agent or environment its own key, so you can revoke one without stopping the others.
  • Revoke a key as soon as it’s no longer needed, or if it may have been seen by someone who shouldn’t have it.
  • Keep Require human review before Done on until you trust the agent’s work.

    Type to search every page. ↑ ↓ to move, Enter to open.