DigitalOcean Gradient AI Agents

Fabric can talk to DigitalOcean Gradient™ AI Agents by using DigitalOcean's OpenAI-compatible inference endpoint. You provide a model access key for inference plus an optional DigitalOcean API token for model discovery.

Prerequisites

1. Create or locate a Gradient AI Agent in the DigitalOcean control panel.
2. Create a model access key for inference (this is not the same as your DigitalOcean API token).
3. (Optional) Keep a DigitalOcean API token handy if you want fabric --listmodels to query the control plane for available models.

The official walkthrough for creating and using agents is here: https://docs.digitalocean.com/products/gradient-ai-platform/how-to/use-agents/

Environment variables

Set the following environment variables before running fabric --setup:

# Required: model access key for inference
export DIGITALOCEAN_INFERENCE_KEY="your-model-access-key"

# Optional: control-plane token for model listing
export DIGITALOCEAN_TOKEN="your-digitalocean-api-token"

# Optional: override the default inference base URL
export DIGITALOCEAN_INFERENCE_BASE_URL="https://inference.do-ai.run/v1"

If you need a region-specific inference URL, you can retrieve it from the GenAI regions API:

curl -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/gen-ai/regions"

Fabric setup

Run setup and select the DigitalOcean vendor:

fabric --setup

Then list models (requires DIGITALOCEAN_TOKEN) and pick the inference name:

fabric --listmodels
fabric --vendor DigitalOcean --model <inference_name> --pattern summarize

If you skip DIGITALOCEAN_TOKEN, you can still use Fabric by supplying the model name directly based on the agent or model you created in DigitalOcean.