diff --git a/README.md b/README.md index 08e10f4f..aacb44e7 100644 --- a/README.md +++ b/README.md @@ -5,6 +5,9 @@ This app brings a user interface to use the Nextcloud text processing feature. It allows users to launch AI tasks, be notified when they finish and see the results. The assistant also appears in others apps like Text to easily process parts of a document. +More details on the assistant OCS API and frontend integration possibilities in the +[developer doc](https://github.com/nextcloud/assistant/raw/main/docs/developer) + ### How to use it A new right header menu entry appears. Once clicked, the assistant is displayed and you can select and task type and @@ -18,6 +21,8 @@ Other apps can integrate with the assistant. For example, Text will display an i to directly select a task type to process this paragraph. Selecting a task this way will open the assistant with the task being pre-selected and the input text set. +More details and screenshots in the [user doc](https://github.com/nextcloud/assistant/raw/main/docs/user). + ## Features In the assistant, the list of available tasks depends on the available providers installed via other apps. diff --git a/appinfo/info.xml b/appinfo/info.xml index 3bfc28ea..bf066eeb 100644 --- a/appinfo/info.xml +++ b/appinfo/info.xml @@ -9,6 +9,9 @@ This app brings a user interface to use the Nextcloud text processing feature. It allows users to launch AI tasks, be notified when they finish and see the results. The assistant also appears in others apps like Text to easily process parts of a document. +More details on the assistant OCS API and frontend integration possibilities in the +[developer doc](https://github.com/nextcloud/assistant/raw/main/docs/developer) + ### How to use it A new right header menu entry appears. Once clicked, the assistant is displayed and you can select and task type and @@ -22,6 +25,8 @@ Other apps can integrate with the assistant. For example, Text will display an i to directly select a task type to process this paragraph. Selecting a task this way will open the assistant with the task being pre-selected and the input text set. +More details and screenshots in the [user doc](https://github.com/nextcloud/assistant/raw/main/docs/user). + ## Features In the assistant, the list of available tasks depends on the available providers installed via other apps. diff --git a/docs/README.md b/docs/README.md index f1f8e138..504d7a7f 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,5 +1,5 @@ -# Assistant developer doc - -This documentation is about [integrating the assistant](./web-integration.md) in the frontend of other Nextcloud applications -and about using the [OCS API](./ocs-api.md) to support assistant features in your application or client. +# Assistant docs +* [User documentation](./user) +* [Developer documentation](./developer) +* [AI admin doc](https://docs.nextcloud.com/server/latest/admin_manual/ai/index.html) diff --git a/docs/developer/README.md b/docs/developer/README.md new file mode 100644 index 00000000..f1f8e138 --- /dev/null +++ b/docs/developer/README.md @@ -0,0 +1,5 @@ +# Assistant developer doc + +This documentation is about [integrating the assistant](./web-integration.md) in the frontend of other Nextcloud applications +and about using the [OCS API](./ocs-api.md) to support assistant features in your application or client. + diff --git a/docs/ocs-api.md b/docs/developer/ocs-api.md similarity index 78% rename from docs/ocs-api.md rename to docs/developer/ocs-api.md index 4c9f3086..b2e1019f 100644 --- a/docs/ocs-api.md +++ b/docs/developer/ocs-api.md @@ -8,5 +8,5 @@ This API is documented with OpenAPI. You can view it with the [ocs_api_viewer ap * browse the ocs_api_viewer app * select "assistant" in the left sidebar -For the moment we have different endpoints for Text Processing, Speech to text and Image generation. This will be unified -in the near future. +For the moment we have different endpoints for Text Processing, Speech to text and Image generation. +This will be unified in the near future so there might be breaking changes to this API. diff --git a/docs/web-integration.md b/docs/developer/web-integration.md similarity index 100% rename from docs/web-integration.md rename to docs/developer/web-integration.md diff --git a/docs/img/assistant.png b/docs/img/assistant.png new file mode 100644 index 00000000..10c3b6e9 Binary files /dev/null and b/docs/img/assistant.png differ diff --git a/docs/img/getting.results.png b/docs/img/getting.results.png new file mode 100644 index 00000000..0c7df76f Binary files /dev/null and b/docs/img/getting.results.png differ diff --git a/docs/img/history.png b/docs/img/history.png new file mode 100644 index 00000000..6e60c265 Binary files /dev/null and b/docs/img/history.png differ diff --git a/docs/img/notifications.png b/docs/img/notifications.png new file mode 100644 index 00000000..0bf6cfb0 Binary files /dev/null and b/docs/img/notifications.png differ diff --git a/docs/img/scheduled.png b/docs/img/scheduled.png new file mode 100644 index 00000000..0d28fdaf Binary files /dev/null and b/docs/img/scheduled.png differ diff --git a/docs/img/smart.picker.audio.png b/docs/img/smart.picker.audio.png new file mode 100644 index 00000000..e62dbb32 Binary files /dev/null and b/docs/img/smart.picker.audio.png differ diff --git a/docs/img/smart.picker.image.png b/docs/img/smart.picker.image.png new file mode 100644 index 00000000..a88b9874 Binary files /dev/null and b/docs/img/smart.picker.image.png differ diff --git a/docs/img/smart.picker.in.text.png b/docs/img/smart.picker.in.text.png new file mode 100644 index 00000000..c304ee32 Binary files /dev/null and b/docs/img/smart.picker.in.text.png differ diff --git a/docs/img/smart.picker.talk.png b/docs/img/smart.picker.talk.png new file mode 100644 index 00000000..4a6bef95 Binary files /dev/null and b/docs/img/smart.picker.talk.png differ diff --git a/docs/img/smart.picker.text.png b/docs/img/smart.picker.text.png new file mode 100644 index 00000000..52f08181 Binary files /dev/null and b/docs/img/smart.picker.text.png differ diff --git a/docs/img/top.right.button.png b/docs/img/top.right.button.png new file mode 100644 index 00000000..3862cd48 Binary files /dev/null and b/docs/img/top.right.button.png differ diff --git a/docs/user/README.md b/docs/user/README.md new file mode 100644 index 00000000..6d268b08 --- /dev/null +++ b/docs/user/README.md @@ -0,0 +1,58 @@ +# User documentation + +## Personal settings + +The Assistant personal settings can be found under the "Artificial intelligence" section. +You can disable the assistant top menu entry there. You can also disable the AI-related smart pickers. + +## Assistant + +### Run a task + +To run a task with the Assistant, just open it via the top menu entry (on the top right). + +![top right icon](../img/top.right.button.png) + +Then choose a task type at the top of the assistant. +Then fill up the input form and press the submit button at the bottom right. + +![assistant](../img/assistant.png) + +You task will run immediately if possible or be scheduled for later execution. + +![getting results](../img/getting.results.png) + +![scheduled](../img/scheduled.png) + +### Notifications + +If the task was scheduled, you will receive a notification when it has finished. +You can display the task results by clicking the "View results" button in the notification. + +![notifications](../img/notifications.png) + +### History + +On the bottom left corner of the assistant, there is a button to display the task history. +This task history is filtered to only show tasks of the currently selected task type. +You can then relaunch previous tasks, delete them or just cancel them if they were scheduled. + +![task history](../img/history.png) + +## Smart picker + +The assistant app provides 3 smart pickers that you can access in Talk, +Text and in every place where rich text edition is possible. +To use them, type "/" and then "ai". They will appear in the filtered provider list. + +In Talk: +![smart picker in talk](../img/smart.picker.talk.png) +In Text: +![smart picker in text](../img/smart.picker.in.text.png) + +The pickers: +![smart picker image generation](../img/smart.picker.image.png) +![smart picker audio transcription](../img/smart.picker.audio.png) +![smart picker text generation](../img/smart.picker.text.png) + +If possible, the picker result will be directly inserted in the current context.