From 306eac8a58669af2d9046108254623a46074edef Mon Sep 17 00:00:00 2001 From: Shuchang Zheng Date: Tue, 27 May 2025 11:06:12 -0700 Subject: [PATCH] simplify credentials doc (#2488) --- fern/browser-sessions/introduction.mdx | 28 ++++++++++++++++++++----- fern/credentials/credit-cards.mdx | 17 +++++++-------- fern/credentials/introduction.mdx | 4 ++-- fern/credentials/passwords.mdx | 11 +++++----- fern/credentials/totp.mdx | 2 +- fern/docs.yml | 4 ++-- fern/workflows/consistent-workflows.mdx | 2 +- 7 files changed, 43 insertions(+), 25 deletions(-) diff --git a/fern/browser-sessions/introduction.mdx b/fern/browser-sessions/introduction.mdx index a80b1d88..d05c3c42 100644 --- a/fern/browser-sessions/introduction.mdx +++ b/fern/browser-sessions/introduction.mdx @@ -12,6 +12,7 @@ Skyvern Browser Session is a way to persist the real-time state of the browser, Skyvern Browser Sessions is currently is only available via [API & SDK](/api-reference/api-reference/browser-session/create-browser-session). ## Create a Browser Session +- [API doc](/api-reference/api-reference/browser-session/create-browser-session) ```python from skyvern import Skyvern @@ -22,12 +23,29 @@ browser_session = await skyvern.browser_sessions.create_browser_session( ) ``` -The `timeout` parameter (`>=5, <=10080`) is the max time in minutes that the browser session can run. +- The `timeout` parameter (`>=5, <=10080`) is the max time in minutes that the browser session can run. By default, the timeout is 60 minutes. +- The `browser_session_id` the session ID you should note. +## Get A Browser Session +- [API doc](/api-reference/api-reference/browser-session/get-browser-session) +```python +from skyvern import Skyvern -## Get Information Of A Browser Session -[API doc](/api-reference/api-reference/browser-session/get-browser-session) +skyvern = Skyvern(api_key="YOUR_API_KEY") +browser_session = await skyvern.browser_sessions.get_browser_session( + browser_session_id="YOUR_BROWSER_SESSION_ID", +) +``` -## Close a Browser Session -[API doc](/api-reference/api-reference/browser-session/close-browser-session) \ No newline at end of file +## Close A Browser Session +- [API doc](/api-reference/api-reference/browser-session/close-browser-session) + +```python +from skyvern import Skyvern + +skyvern = Skyvern(api_key="YOUR_API_KEY") +await skyvern.browser_sessions.close_browser_session( + browser_session_id="YOUR_BROWSER_SESSION_ID", +) +``` \ No newline at end of file diff --git a/fern/credentials/credit-cards.mdx b/fern/credentials/credit-cards.mdx index 3954da81..45a90fcd 100644 --- a/fern/credentials/credit-cards.mdx +++ b/fern/credentials/credit-cards.mdx @@ -4,28 +4,27 @@ subtitle: How to manage credit cards in Skyvern slug: credentials/credit-cards --- -## Manage Credit Cards in Skyvern Cloud -You can go to [Skyvern's Credentials page](https://app.skyvern.com/credentials) to manage your credit cards. +## Manage Credit Cards +Same as passwords, credit cards are also managed in the [Skyvern's Credentials](https://app.skyvern.com/credentials) page. - -**Add a new credit card credential:** +### Add a new credit card: -**Delete a credit card credential:** +### Delete a credit card: Click the trash icon and confirm the deletion. If you do this, the credit card will be deleted from Skyvern PERMANENTLY. -**Update a credit card credential:** +### Update a credit card: Skyvern only supports adding and deleting credit cards. To update a credit card, you need to delete the existing credit card and create a new one. -## Manage Credit Cards with API & SDK +## API & SDK We also have [API and SDK](/api-reference/api-reference/credentials/create-credential) supports for credit card management: -**Create a new credit card credential:** +### Create a new credit card: ```python title="python" @@ -64,7 +63,7 @@ curl -X POST https://api.skyvern.com/v1/credentials \ ``` -**Delete a password credential:** +### Delete a credit card: ```python title="python" diff --git a/fern/credentials/introduction.mdx b/fern/credentials/introduction.mdx index 99529d6a..a3dc9ece 100644 --- a/fern/credentials/introduction.mdx +++ b/fern/credentials/introduction.mdx @@ -1,10 +1,10 @@ --- -title: Secure Credential Management For AI Agents +title: Credential Management subtitle: Never send your credentials to LLMs. slug: credentials/introduction --- -In many scenarios, agents need access to sensitive information to complete tasks. For example, usernames and passwords to login, credit cards for payments, etc. With Skyvern's credential features, you can manage and use credentials to run agents securely without exposing your credentials to LLMs. +Agents need access to sensitive information to complete tasks. For example, usernames and passwords to login, credit cards for payments, etc. With Skyvern's credential management tool, you can run agents securely without exposing your credentials to LLMs. ## Credential Support diff --git a/fern/credentials/passwords.mdx b/fern/credentials/passwords.mdx index 80b64e34..ab5506a2 100644 --- a/fern/credentials/passwords.mdx +++ b/fern/credentials/passwords.mdx @@ -8,9 +8,10 @@ slug: credentials/passwords You can store passwords information in Skyvern. Skyvern agent can use the stored password information to log into a website without sending your username or password to LLMs. -## Manage Passwords in Skyvern Cloud -You can go to [Skyvern's Credentials page](https://app.skyvern.com/credentials) to manage your passwords. -**Add a new password credential:** +## How To Manage Passwords +This can be done in the [Skyvern's Credentials](https://app.skyvern.com/credentials) page. + +### Add a new password: @@ -18,12 +19,12 @@ Besides the username and password, you can also add the Two Factor Authenticatio -**Delete a password credential:** +### Delete a password: Click the trash icon and confirm the deletion. If you do this, the password will be deleted from Skyvern PERMANENTLY. -**Update a password credential:** +### Update a password: Skyvern only allows adding and deleting passwords. If you would like to update a password, you need to delete the existing password and create a new one. ## Manage Passwords with API & SDK diff --git a/fern/credentials/totp.mdx b/fern/credentials/totp.mdx index 2be29725..727980f3 100644 --- a/fern/credentials/totp.mdx +++ b/fern/credentials/totp.mdx @@ -1,6 +1,6 @@ --- title: 2FA Support (TOTP) -subtitle: How to send TOTP codes (2FA/MFA/Verification Code) to Skyvern +subtitle: How to send 2FA codes (TOTP) to Skyvern slug: credentials/totp --- diff --git a/fern/docs.yml b/fern/docs.yml index 2ab3f38a..96cb9c3b 100644 --- a/fern/docs.yml +++ b/fern/docs.yml @@ -98,7 +98,7 @@ navigation: path: workflows/workflow-parameters.mdx - page: Run Workflows path: workflows/run-workflows.mdx - - page: Make Workflows Consistent And Reliable + - page: Consistency and Reliability path: workflows/consistent-workflows.mdx - page: Running Workflows path: workflows/running-workflows.mdx @@ -120,7 +120,7 @@ navigation: hidden: true - section: Credentials contents: - - page: Introduction + - page: Overview path: credentials/introduction.mdx - page: Password Management path: credentials/passwords.mdx diff --git a/fern/workflows/consistent-workflows.mdx b/fern/workflows/consistent-workflows.mdx index 0241882f..86b5d362 100644 --- a/fern/workflows/consistent-workflows.mdx +++ b/fern/workflows/consistent-workflows.mdx @@ -1,5 +1,5 @@ --- -title: Make Workflows Consistent And Reliable +title: Consistency and Reliability slug: workflows/consistent-workflows ---