Files
Fabric/docs/DigitalOcean-Agents-Setup.md
Kayvan Sylvan c26a56a368 feat: add DigitalOcean Gradient AI Agents as a new vendor
## CHANGES

- Add DigitalOcean as a new AI provider in plugin registry
- Implement DigitalOcean client with OpenAI-compatible inference endpoint
- Support model access key authentication for inference requests
- Add optional control plane token for model discovery
- Create DigitalOcean setup documentation with environment variables
- Update README to list DigitalOcean in supported providers
- Handle model listing via control plane API with fallback
2026-01-13 22:52:13 -08:00

1.8 KiB

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.