Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

IBX-8689: AI Actions documentation #2473

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

IBX-8689: AI Actions documentation #2473

wants to merge 1 commit into from

Conversation

dabrt
Copy link
Contributor

@dabrt dabrt commented Aug 20, 2024

Question Answer
JIRA Ticket IBX-8689
Versions 4.6 and up
Edition all

Prepare a foundation for the documentation of AI Actions add-on.

Checklist

  • Text renders correctly
  • Text has been checked with vale
  • Description metadata is up to date
  • Added link to this PR in relevant JIRA ticket or code PR

Copy link
Contributor

@mnocon mnocon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As we've discussed - I like it! Just a couple of smaller comments

Built upon the PHP framework, AI Actions offer an extensible solution for integrating services provided by AI engines into your workflows, all managed through a user-friendly interface.

You can extend the add-on and make it do different things, for example, transform text passages, or generate illustrations for your articles based on a prompt.
The possibilities are endless.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The possibilities are endless.
The possibilities are endless and you're not limited to a specific AI service, avoiding vendor lock-in.

In the evolving landscape of digital experience, artificial intelligence becomes more and more important by enhancing user interaction and automating complex tasks.
To harness AI's potential, [[= product_name =]] introduces th AI Actions add-on, which you can install and use to automate various time-consuming tasks, for example, generating alt text for images.

Built upon the PHP framework, AI Actions offer an extensible solution for integrating services provided by AI engines into your workflows, all managed through a user-friendly interface.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Built upon the PHP framework, AI Actions offer an extensible solution for integrating services provided by AI engines into your workflows, all managed through a user-friendly interface.
Built upon the PHP framework, AI Actions offer an extensible solution for integrating services provided by AI services into your workflows, all managed through a user-friendly interface.


## Availability

AI Actios are available as an add-on to the v.4.6.x version of [[= product_name =]], regardless of its edition.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
AI Actios are available as an add-on to the v.4.6.x version of [[= product_name =]], regardless of its edition.
AI Actions are available as an add-on to the v4.6.x version of [[= product_name =]], regardless of its edition.


#### Action types

Action types are predefined by developers within YAML configuration.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Action types are predefined by developers within YAML configuration.
Action types are predefined by developers.

It's YAML, but not YAML configuration - it's part of the Symfony Container definitions.

I mean: https://github.com/ibexa/connector-ai/blob/main/src/bundle/Resources/config/services/action_types.yaml is closer to "code" than "configuration" (and it's possible to define Action Type s using PHP code)

Comment on lines +19 to +21
To check for the presence of AI Actions in your application, run the following command:

`composer show | grep "ibexa/connector-ai"`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We don't need this part.

Ibexa Engage is available from v4.6.x of [[= product_name =]].
Run the following command to install the bundle:

`composer require ibexa/connector-ai`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just the framework. To get the out of the box OpenAI integration you also need ibexa/connector-openai (a second package).


## Prepare configuration files

When you install AI Actions add-on, it modifies the YAML configuration files by adding configuration keys similar to this example:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To configure the default actions (alt text, possibly refine text) only the OpenAPI token needs to be specified in env variables


## Install AI Actions

Ibexa Engage is available from v4.6.x of [[= product_name =]].
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Ibexa Engage is available from v4.6.x of [[= product_name =]].
AI feature is available from v4.6.x of [[= product_name =]].

😛

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants