Harvest Forecast

The Harvest Forecast connector allows the chatbot to manage resource planning, assignments, and project scheduling through the Forecast API using Agentgateway.

Connector Settings

Usage Examples

Once connected, users can interact with Forecast through natural language:

• "Who is assigned to the marketing project next week?"
• "Show me all active assignments"
• "How many hours are scheduled for this month?"

Tools

Get Remaining Budgeted Hours

getRemainingBudgetedHours

Returns the remaining budgeted hours, project by project.

Get Client

getClient

Returns a Client.

Parameters:

• path -
  • id - Id of the Client

List Clients

listClients

Returns a list of clients.

Delete Placeholder

deletePlaceholder

Delete a Placeholder.

Parameters:

• path -
  • id - Id of the Placeholder

Get Account

getAccount

Returns an account details.

Parameters:

• path -
  • id - Id of the account

Count Scheduled Hours

countScheduledHours

Returns the number of scheduled hours.

Parameters:

• path -
  • date - The date after which to lookup

Get Assignment

getAssignment

Returns an Assignment.

Parameters:

• path -
  • id - Id of the Assignment

Get Placeholder

getPlaceholder

Returns a Placeholder.

Parameters:

• path -
  • id - Id of the Placeholder

List Repeated Assignment Sets

listRepeatedAssignmentSets

Returns a list of Repeated Assignment Sets.

Who Am I

whoAmI

Returns the user profile.

Edit Assignment

editAssignment

Edits an assignment.

Parameters:

• body -
  • assignment -
• path -
  • id - Id of the Assignment

Delete Assignment

deleteAssignment

Delete an Assignment.

Parameters:

• path -
  • id - Id of the Assignment

List Assignments

listAssignments

Returns a list of assignments.

Parameters:

• query -
  • state - Pass "active" to only return assignments for currently active users
  • end_date - Only return assignments before this date
  • person_id - Only return assignments for this person
  • project_id - Only return assignments for this project
  • start_date - Only return assignments after this date
  • repeated_assignment_set - Only return assignments for this repeated assignment set

Create Assignment

createAssignment

Creates an assignment.

Parameters:

• body -
  • assignment -

Get Person

getPerson

Returns a Person.

Parameters:

• path -
  • id - Id of the Person

Edit Person

editPerson

Edits a Person.

Parameters:

• body -
  • person -
• path -
  • id - Id of the Person

Delete Person

deletePerson

Delete a Person.

Parameters:

• path -
  • id - Id of the Person

List People

listPeople

Returns a list of people.

Parameters:

• query -
  • state - Pass "active" to only return active users. Any other value also returns archived users.

Create Person

createPerson

Create a Person.

Parameters:

• body -
  • person -

Edit Placeholder

editPlaceholder

Edit a Placeholder.

Parameters:

• body -
  • placeholder -
• path -
  • id - Id of the Placeholder

List Placeholders

listPlaceholders

Returns a list of placeholders.

Create Placeholder

createPlaceholder

Create a Placeholder.

Parameters:

• body -
  • placeholder -

Get Project

getProject

Returns a Project.

Parameters:

• path -
  • id - Id of the Project

List Projects

listProjects

Returns a list of projects.

Get Role

getRole

Returns a Role.

Parameters:

• path -
  • id - Id of the Role

Edit Role

editRole

Edit a Role.

Parameters:

• body -
  • role -
• path -
  • id - Id of the Role

Delete Role

deleteRole

Delete a Role.

Parameters:

• path -
  • id - Id of the Role

List Roles

listRoles

Returns a list of Roles.

Create Role

createRole

Creates a Role.

Parameters:

• body -
  • role -

Get Repeated Assignment Set

getRepeatedAssignmentSet

Returns a Repeated Assignment Set.

Parameters:

• path -
  • id - Id of the RepeatedAssignmentSet

Edit Repeated Assignment Set

editRepeatedAssignmentSet

Modifies a Repeated Assignment Set.

Parameters:

• body -
  • repeated_assignment_set -
• path -
  • id - Id of the RepeatedAssignmentSet

Delete Repeated Assignment Set

deleteRepeatedAssignmentSet

Delete a Repeated Assignment Set.

Parameters:

• path -
  • id - Id of the Repeated Assignment Set

Create Repeated Assignment Set

createRepeatedAssignmentSet

Creates a Repeated Assignment Set.

Parameters:

• body -
  • repeated_assignment_set -