Skip to main content

Managing Agents

The Distri Cloud dashboard lets you view, test, and manage all your agents in one place.

Viewing Your Agents​

Go to app.distri.dev to see your agents.

The dashboard shows two sections:

Owned by You​

Agents you've created and pushed from your local environment. You have full control over these agents.

Explore​

Public agents shared by the community. You can use these in your applications or clone them as starting points.

Pushing Agents​

Use the CLI to push agent definitions to the cloud:

# Push all agents in the agents/ directory
distri push

# Push a specific agent
distri push agents/my_agent.md

After pushing, your agent appears in the dashboard and is immediately available via API.

Agent Details​

Click any agent to view its details:

  • Description — What the agent does
  • Configuration — Model settings, tools, and parameters
  • Chat — Test the agent interactively
  • Threads — View conversation history

Testing Agents​

In the Dashboard​

  1. Click on an agent
  2. Use the built-in chat interface
  3. View tool calls and responses in real-time

Via CLI​

distri run my_agent --task "Your test prompt here"

Via API​

curl -X POST https://api.distri.dev/v1/agents/my_agent \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "message/send",
    "params": {
      "message": {
        "kind": "message",
        "role": "user",
        "parts": [{"kind": "text", "text": "Test message"}]
      }
    }
  }'

Publishing Agents​

Make your agent available to others:

  1. Open the agent details
  2. Click Publish
  3. Your agent appears in the "Explore" section

Published agents can be:

  • Discovered by other users
  • Cloned as starting points
  • Invoked (if you allow it)

To unpublish, click Unpublish in the agent details.

Cloning Agents​

Start from an existing agent:

  1. Find an agent in "Explore"
  2. Click Clone
  3. The agent is copied to your account
  4. Modify it as needed

Agent Types​

TypeIconDescription
Bot🤖Standard conversational agent
Sequential Workflow➡️Multi-step sequential process
DAG Workflow🔀Parallel/branching workflow
Custom⚙️Custom agent implementation

Deleting Agents​

To remove an agent:

  1. Open the agent details
  2. Click Delete
  3. Confirm deletion
warning

Deleting an agent removes all its configuration. Existing threads and history are preserved but the agent can no longer be invoked.

Agent Versions​

When you push updates to an agent:

  1. The new definition replaces the old one
  2. Existing threads continue working
  3. New invocations use the updated configuration

For versioned deployments, use different agent names (e.g., my_agent_v1, my_agent_v2).

Best Practices​

  1. Use descriptive names — customer_support_agent not agent1
  2. Write clear descriptions — Help users understand what the agent does
  3. Test before publishing — Verify behavior with the built-in chat
  4. Start from templates — Clone existing agents to learn patterns
  5. Iterate locally — Use distri run during development, then push