aljaz/goose
1
0
Fork 0
mirror of https://github.com/aljazceru/goose.git synced 2025-12-17 14:14:26 +01:00
Code Issues Packages Projects Releases Wiki Activity

docs: Add Automatically enabled extensions section to Using Extensions (#2534)

Browse Source
This commit is contained in:
dianed-square
2025-05-14 12:30:04 -07:00
committed by GitHub
parent d900d5c7d1
commit ad899a9de4
2 changed files with 123 additions and 134 deletions
Download Patch File Download Diff File Expand all files Collapse all files

125
documentation/docs/getting-started/using-extensions.md
View File

@@ -299,10 +299,131 @@ You can enable or disable installed extensions based on your workflow needs.
</TabItem> </TabItem>
</Tabs> </Tabs>
:::tip ## Automatically Enabled Extensions
Goose can automatically detect and suggest the right extensions for your tasks as you chat. Learn more about this smart feature in the [Smart Extension](/docs/guides/smart-extension-recommendation) guide.
The Smart Extension Recommendation system in Goose automatically identifies and suggests relevant extensions based on your tasks and needs. This section explains how to use this feature effectively and understand its capabilities and limitations.
When you request a task, Goose checks its enabled extensions and their tools to determine if it can fulfill the request. If not, it suggests or enables additional extensions as needed. You can also request specific extensions by name.
:::warning
Any extensions enabled dynamically are only enabled for the current session. To keep extensions enabled between sessions, see [Enabling/Disabling Extensions](#enablingdisabling-extensions).
::: :::
### Automatic Detection
Goose automatically detects when an extension is needed based on your task requirements. Here's an example of how Goose identifies and enables a needed extension during a conversation:
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
#### Goose Prompt
```plaintext
Find all orders with pending status from our production database
```
#### Goose Output
```plaintext
I'll help you search for available extensions that might help us interact with PostgreSQL databases.
🔍 Search Available Extensions
└─ Output ▼
I see there's a PostgreSQL extension available. Let me enable it so we can query your database.
🔧 Manage Extensions
└─ action enable
extension_name postgresql
The extension 'postgresql' has been installed successfully
Great! Now I can help you query the database...
```
</TabItem>
<TabItem value="cli" label="Goose CLI">
#### Goose Prompt
```plaintext
Find all orders with pending status from our production database
```
#### Goose Output
```sh
I apologize, but I notice that I don't currently have access to your database. Let me search if there are any database-related extensions available.
─── search_available_extensions | platform ──────────────────────────
I see that there is a "postgresql" extension available. Let me enable it so I can help you query your database.
─── enable_extension | platform ──────────────────────────
extension_name: postgresql
■ Goose would like to enable the following extension, do you approve?
// highlight-start
| ● Yes, for this session
// highlight-end
| ○ No
```
</TabItem>
</Tabs>
### Direct Request
Goose responds to explicit requests for extensions, allowing users to manually enable specific tools they need. Here's an example of how Goose handles a direct request to enable an extension:
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
#### Goose Prompt
```plaintext
Use PostgreSQL extension
```
#### Goose Output
```plaintext
I'll help enable the PostgreSQL extension for you.
🔧 Manage Extensions
└─ action enable
extension_name postgresql
The extension 'postgresql' has been installed successfully
The PostgreSQL extension is now ready to use. What would you like to do with it?
```
</TabItem>
<TabItem value="cli" label="Goose CLI">
#### Goose Prompt
```sh
Use the PostgreSQL extension
```
#### Goose Output
```sh
I'll help enable the PostgreSQL extension for you.
─── enable_extension | platform ──────────────────────────
extension_name: postgresql
■ Goose would like to enable the following extension, do you approve?
// highlight-start
| ● Yes, for this session
// highlight-end
| ○ No
```
</TabItem>
</Tabs>
## Removing Extensions ## Removing Extensions
You can remove installed extensions. You can remove installed extensions.

132
documentation/docs/guides/smart-extension-recommendation.md
View File

@@ -1,132 +0,0 @@
---
title: Smart Extension Recommendation
sidebar_position: 21
sidebar_label: Smart Extension Recommendation
description: Learn how Goose dynamically discovers and manages extensions
---
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
The Smart Extension Recommendation system in Goose automatically identifies and suggests relevant extensions based on your tasks and needs. This guide explains how to use this feature effectively and understand its capabilities and limitations.
When you request a task, Goose checks its enabled extensions and their tools to determine if it can fulfill the request. If not, it suggests or enables additional extensions as needed. You can also request specific extensions by name.
:::warning
Any extensions enabled dynamically are only enabled for the current session. To keep extensions enabled between sessions, follow the [Using Extensions](/docs/getting-started/using-extensions) guide.
:::
## Automatic Detection
Goose automatically detects when an extension is needed based on your task requirements. Here's an example of how Goose identifies and enables a needed extension during a conversation:
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
#### Goose Prompt
```plaintext
Find all orders with pending status from our production database
```
#### Goose Output
```plaintext
I'll help you search for available extensions that might help us interact with PostgreSQL databases.
🔍 Search Available Extensions
└─ Output ▼
I see there's a PostgreSQL extension available. Let me enable it so we can query your database.
🔧 Manage Extensions
└─ action enable
extension_name postgresql
The extension 'postgresql' has been installed successfully
Great! Now I can help you query the database...
```
</TabItem>
<TabItem value="cli" label="Goose CLI">
#### Goose Prompt
```plaintext
Find all orders with pending status from our production database
```
#### Goose Output
```sh
I apologize, but I notice that I don't currently have access to your database. Let me search if there are any database-related extensions available.
─── search_available_extensions | platform ──────────────────────────
I see that there is a "postgresql" extension available. Let me enable it so I can help you query your database.
─── enable_extension | platform ──────────────────────────
extension_name: postgresql
■ Goose would like to enable the following extension, do you approve?
// highlight-start
| ● Yes, for this session
// highlight-end
| ○ No
```
</TabItem>
</Tabs>
## Direct Request
Goose responds to explicit requests for extensions, allowing users to manually enable specific tools they need. Here's an example of how Goose handles a direct request to enable an extension:
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
#### Goose Prompt
```plaintext
Use PostgreSQL extension
```
#### Goose Output
```plaintext
I'll help enable the PostgreSQL extension for you.
🔧 Manage Extensions
└─ action enable
extension_name postgresql
The extension 'postgresql' has been installed successfully
The PostgreSQL extension is now ready to use. What would you like to do with it?
```
</TabItem>
<TabItem value="cli" label="Goose CLI">
#### Goose Prompt
```sh
Use the PostgreSQL extension
```
#### Goose Output
```sh
I'll help enable the PostgreSQL extension for you.
─── enable_extension | platform ──────────────────────────
extension_name: postgresql
■ Goose would like to enable the following extension, do you approve?
// highlight-start
| ● Yes, for this session
// highlight-end
| ○ No
```
</TabItem>
</Tabs>