Repository files navigation

💡Heroku Integration Pilot:
These steps utilize generally availble features in Heroku and Salesforce. If you have joined the Heroku Integration pilot program please refer to these alternativeinstructions.

This tutorial explains how to deploy a Heroku application written in Python that can be used to build an Agentforce custom action, extending the capabilities of any Agentforce agent with the power of Heroku's fully managed, elastic compute services.

IN A HURRY? This application has already been deployed publicly and is available athttps://agentforce-tutorial-python-7894e9215571.herokuapp.com/, allowing you to skip straight toconfiguring Heroku-based actions in your Salesforce organization to try it out first.

Regardless of how you access this app, you will need to complete or configure basic authentication. We have included this as a reminder that best practice is to always consider authentication for APIs, especially those involved in AI interactions like this. For APIs in general, it is typical to use JWT-based authentication. For the basic authentication setup here, the default username isheroku, and the password isagent.

WARNING: Carefully review your app authentication needs and requirements before deploying to production.

You can deploy this application to your Heroku account using the button below or manually via the CLI.

To proceed with a CLI deployment, install theHeroku CLI and log in with your Heroku account (orsign up). Then, execute the following CLI commands:

git clone https://github.com/heroku-examples/heroku-agentforce-tutorial-pythoncd heroku-agentforce-tutorial-pythonheroku create myagentactiongit push heroku main

Once this has been deployed, take note of the web URL and then refer to the instructions inconfiguring Heroku-based actions in your Salesforce organization.

Although you cannot integrate this app with Agentforce until you deploy it, you can still develop and test your action’s inputs and outputs locally, using the built-inSwagger UI. Once you are satisfied with your changes, refer to the deployment and configuration steps above.

git clone https://github.com/heroku-examples/heroku-agentforce-tutorial-pythoncd heroku-agentforce-tutorial-pythonpython -m venv venvsource venv/bin/activatepip install -r requirements.txtpython app.py

Once the application is running, navigate to the URL below, click theTry it Out button, and complete the basic authentication as covered above.

http://127.0.0.1:5000