Skip to content

Commit

Permalink
Add documentation for configuring bucket credentials for S3, GCP, and…
Browse files Browse the repository at this point in the history
… Cloudflare. (#33)
  • Loading branch information
nlindellalderman authored Nov 13, 2024
1 parent 8098172 commit 8b8b034
Show file tree
Hide file tree
Showing 8 changed files with 110 additions and 0 deletions.
12 changes: 12 additions & 0 deletions fern/customization/provider-keys.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,3 +24,15 @@ You can find more details in the [Custom LLMs](/customization/custom-llm/fine-tu
## Voice Providers

All voice providers are supported. Once you've validated your API through the [Dashboard](https://dashboard.vapi.ai), any voice ID from your provider can be used in the `voice.voiceId` field of the [Assistant](/api-reference/assistants/create-assistant).

## Cloud Providers

Vapi stores recordings of conversations with assistants in the cloud. By default, Vapi stores these recordings in its
own bucket in Cloudflare R2. You can configure Vapi to store recordings in your own bucket in AWS S3, GCP, or
Cloudflare R2.

You can find more details on how to configure your Cloud Provider keys here:

* [AWS S3](/providers/cloud/s3)
* [GCP Cloud Storage](/providers/cloud/gcp)
* [Cloudflare R2](/providers/cloud/cloudflare)
8 changes: 8 additions & 0 deletions fern/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -334,6 +334,14 @@ navigation:
path: providers/transcriber/gladia.mdx
- page: Talkscriber
path: providers/transcriber/talkscriber.mdx
- section: Cloud
contents:
- page: AWS S3
path: providers/cloud/s3.mdx
- page: GCP Cloud Storage
path: providers/cloud/gcp.mdx
- page: Cloudflare R2
path: providers/cloud/cloudflare.mdx
- page: Voiceflow
path: providers/voiceflow.mdx
- section: Security & Privacy
Expand Down
31 changes: 31 additions & 0 deletions fern/providers/cloud/cloudflare.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
---
title: Cloudflare R2
subtitle: Store recordings of chat conversations in Cloudflare R2
slug: providers/cloud/cloudflare
---

Your assistants can be configured to record chat conversations and upload
the recordings to a bucket in Cloudflare R2 when the conversation ends. You will
need to configure the credential and bucket settings in the "Cloud Providers"
section of the "Provider Credentials" page in the Vapi dashboard.

See these [instructions](https://developers.cloudflare.com/r2/api/s3/tokens/) for generating R2 tokens and access keys.

## Credential Settings

Setting | Description
------------------------ | -------------------------------------------------------
Cloudflare Account ID | Your customer account id for Cloudflare
Cloudflare Account Email | The email address associated with the account id
Cloudflare API Key/Token | The value of an API Key/Token generated for the account (Cloudflare uses the terms API Key and API Token interchangeably)
Bucket Name | The name of the bucket in R2 to upload recordings to
Bucket URL | This is required only for buckets with a custom hostname or domain name. Enter the hostname for the bucket. You will need to set up a CORS policy in R2 for the hostname/domain name. See [instructions](https://developers.cloudflare.com/r2/buckets/cors/) for configuring CORS.
Bucket Path Prefix | An optional path prefix for recordings uploaded to the bucket
Bucket Access Key ID | The access key id associated with the API token you generated for R2 (this a string of 32 characters)
Bucket Secret Access Key | The secret access key associated with the API token you generated for R2 (this is a string of 64 characters)

## Example

<Frame caption="Example Configuration">
<img src="../../static/images/credentials/provider/cloud-provider-cloudflare-r2.png" />
</Frame>
32 changes: 32 additions & 0 deletions fern/providers/cloud/gcp.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
---
title: GCP Cloud Storage
subtitle: Store recordings of chat conversations in GCP Cloud Storage
slug: providers/cloud/gcp
---

Your assistants can be configured to record chat conversations and upload
the recordings to a bucket in GCP Cloud Storage when the conversation ends. You will
need to configure the credential and bucket settings in the "Cloud Providers"
section of the "Provider Credentials" page in the Vapi dashboard.

See these [instructions](https://cloud.google.com/iam/docs/keys-create-delete) for generating service account keys for GCP.

See these [instructions](https://cloud.google.com/storage/docs/authentication/hmackeys) for generating HMAC Keys for Cloud Storage.

## Credential Settings

Setting | Description
------------------------------ | -------------------------------------------------------
Credential Reference Name | The credential reference name
GCP Service Account Key (JSON) | The service account key in JSON format
Bucket Name | The name of the bucket to upload recordings to
Bucket Region | The name of the region where the bucket is located
Bucket Path Prefix | An optional path prefix for recordings uploaded to the bucket
HMAC Access Key | The HMAC access key for the GCP Cloud Storage API (This is a string of 24 characters when linked to a user account or a string of 61 characters when linked to a service account.)
HMAC Secret | The HMAC secret for the GCP Clodu Storage API (This is a 40-character base-64 encoded string.)

## Example

<Frame caption="Example Configuration">
<img src="../../static/images/credentials/provider/cloud-provider-gcp-hmac.png" />
</Frame>
27 changes: 27 additions & 0 deletions fern/providers/cloud/s3.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
title: AWS S3
subtitle: Store recordings of chat conversations in AWS S3
slug: providers/cloud/s3
---

Your assistants can be configured to record chat conversations and upload
the recordings to a bucket in AWS S3 when the conversation ends. You will
need to configure the credential and bucket settings in the "Cloud Providers"
section of the "Provider Credentials" page in the Vapi dashboard.

See these [instructions](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-keys-admin-managed.html) for generating AWS access keys.

## Credential Settings

Setting | Description
------------------------ | -------------------------------------------------------
AWS Access Key ID | The access key id for AWS
AWS Secret Access Key | The secret access key for AWS
S3 Bucket Name | The name of the bucket to upload recordings to
S3 Path Prefix | An optional path prefix for recordings uploaded to the bucket

## Example

<Frame caption="Example Configuration">
<img src="../../static/images/credentials/provider/cloud-provider-aws-s3.png" />
</Frame>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 8b8b034

Please sign in to comment.