Define the connection to the AI service provider

In Alfabet Expand, go to the Presentation tab, expand the XML Objects > Integration Solutions node and double-click AIServicesConfig. The definition of the connection depends on the service provider.

• Connect to Amazon Bedrock

  You can connect to Amazon Bedrock® either via an access key or via a Cognito user pool. The configuration required at Amazon Bedrock for the authentication methods is not part of this documentation.

  In the XML editor, define the following XML structure:

  • <AIServicesConfig>
  • <AIServices>
    • <AIService Name='' Type='TextGenerate' Enable='true' Provider='' Authentication='' Model='' TimeOut=''/>
  • </AIServices>
  • <AIAuthentications>
    • <AIAuthentication Name='' Type='' Flow=''>
    • </AIAuthentication>
  • </AIAuthentications>
  • </AIServicesConfig>

  If the AIServicesConfig , AI Services , and AIAuthentications XML elements already exist, you must only add an AIService child XML element to the existing AIServices XML element and an AIAuthentication child XML element to the existing AIAuthentications XML element.

  Set the attributes of the AIService XML element:

  • Name: Define a unique name for the service definition.
  • Type: Set to TextGenerate.
  • Enable: Set to true to activate the AI service connection. You can define multiple AI service connections of the type TextGenerate, but you can only activate one at a time.
  • Provider: Set to AmazonBedrock.
  • Authentication: Authentication is defined separately in an AIAuthentication XML element. Each AIAuthentication XML element has a unique name. Enter the name you will use for the authentication specification in the next step.
  • Model: Enter the Amazon Bedrock Model ID of the AI model you want to access.
  • TimeOut: Define the timeout of inactive connections to Amazon Bedrock in seconds. The default is 60 seconds.

  Define authentication for access of Amazon Bedrock in the AIAuthentication XML element.

  Define the XML attributes of the AIAuthentication XML element:

  1. Name: Enter the name you specified in the Authentication XML attribute of the AIService XML element.
  2. Type: Select either AWSCognitoUserPool or AWSAccess Key
  3. Flow: Set to USER_PASSWORD_AUTH.

  Define the XML child elements of the AIAuthentication XML element for login with Cognito User Pools:

  You can use server variables for the definition of authentication parameters. Server variables are defined in the configuration file of the Alfabet Web Application and can be stored encrypted. The configuration in the XML object contains the server variable names instead of the values behind them. This method is recommended to specify security critical information like user IDs and passwords.

  • Region: Enter the region of the Amazon web Services you are using.
  • AuthorizationUrl: Enter the authorization URL for access to the Cognito User Pools.
  • ClientId: Enter the client ID of the Cognito user pool.
  • UserPoolId: Enter the ID of the Cognito user pool for user authentication.
  • IdentityPoolId: Enter the ID of the Cognito identity pool for user authorization.
  • Username: Enter the Cognito user name for login.
  • Password: Enter the Cognito user's password.

  Define the XML child elements of the AIAuthentication XML element for login with user access key.:

  You can use server variables for the definition of authentication parameters. Server variables are defined in the configuration file of the Alfabet Web Application and can be stored encrypted. The configuration in the XML object contains the server variable names instead of the values behind them. This method is recommended to specify security critical information like user IDs and passwords.

  • Region: Enter the region of the Amazon Web Services you are using.
  • AccessKey: Enter the Amazon Web Services access key.
  • SecretKey: Enter the Amazon Web Services secret key.
• Connect to Microsoft Foundry

  You can connect to Microsoft Foundry® via API key access to Microsoft Azure®. The configuration required at Microsoft Azure for the authentication method is not part of this documentation.

  In the XML editor, define the following XML structure:

  • <AIServicesConfig>
  • <AIServices>
    • <AIService Name='' Type='TextGenerate' Enable='true' Provider='' Authentication='' Model='' TimeOut=''/>
  • </AIServices>
  • <AIAuthentications>
    • <AIAuthentication Name='' Type='' Flow=''>
    • </AIAuthentication>
  • </AIAuthentications>
  • </AIServicesConfig>

  If the AIServicesConfig , AI Services , and AIAuthentications XML elements already exist, you must only add an AIService child XML element to the existing AIServices XML element and an AIAuthentication child XML element to the existing AIAuthentications XML element.

  Set the attributes of the AIService XML element:

  • Name: Define a unique name for the service definition.
  • Type: Set to TextGenerate.
  • Enable: Set to true to activate the AI service connection. You can define multiple AI service connections of the type TextGenerate, but you can only activate one at a time.
  • Provider: Set to MicrosoftFoundry.
  • EndPoint: Enter the Target URI of your model deployment endpoint on Microsoft Azure.
  • Authentication: Authentication is defined separately in an AIAuthentication XML element. Each AIAuthentication XML element has a unique name. Enter the name you will use for the authentication specification in the next step.
  • Model: Enter the Microsoft Foundry model name of the AI model you want to access.
  • TimeOut: Define the timeout of inactive connections to Microsoft Azure in seconds. The default is 60 seconds.

  Define authentication for access of Microsoft Azure in the AIAuthentication XML element.

  Define the XML attributes of the AIAuthentication XML element:

  1. Name: Enter the name you specified in the Authentication XML attribute of the AIService XML element.
  2. Type: SelectAPIKey

  Define the XML child elements of the AIAuthentication XML element:

  You can use server variables for the definition of authentication parameters. Server variables are defined in the configuration file of the Alfabet Web Application and can be stored encrypted. The configuration in the XML object contains the server variable names instead of the values behind them. This method is recommended to specify security critical information like user IDs and passwords.

  • APIKey: Enter the Authentication Key for access to your model deployment endpoint on Microsoft Azure.
• Connect to Ollama

  In the XML editor, define the following XML structure:

  • <AIServicesConfig>
  • <AIServices>
    • <AIService Name='' Type='TextGenerate' Enable='true' Provider='' ServiceHost='' Model='' TimeOut=''/>
  • </AIServices>
  • </AIServicesConfig>

  If the AIServicesConfig and AI Services XML elements already exist, you must only add an AIService child XML element to the existing AIServices XML element.

  Set the attributes of the AIService XML element:

  • Name: Define a unique name for the service definition.
  • Type: Set to TextGenerate.
  • Enable: Set to true to activate the AI service connection. You can define multiple AI service connections of the type TextGenerate, but you can only activate one at a time.
  • Provider: Set to Ollama.
  • ServiceHost: Enter the URL for access of the Ollama AI service.
  • Model: Enter the Ollama model name of the AI model you want to access.
  • TimeOut: Define the timeout of inactive connections to Ollama in seconds. The default is 60 seconds.