Pigeon Agents Development Running Agents - DatasmithSA/Pigeon-Voice-Training GitHub Wiki
Once you have completed the development of your customer Pigeon Voice Agents contained in an agent library (.NET DLL), you run the the agents within the Pigeon Voice Server by going through the following steps:
- Configure Pigeon Voice Server: in order for you agents to run they need to be loaded by the Pigeon Voice Server on startup. We will use the Pigeon Voice Manager to point the server to our custom agents library.
- Open the Pigeon Voice Manager from the Desktop or the Windows Start menu.
- Select the Agents component in the components list.
- Assembly and Namespaces: In order for the Pigeon Voice Server to load the Agents library we will need to provide the name of the assembly as well as the namespace in which our our agents are located within the library. In this example we have both our TCP/IP (LUT & ODR) and HTTP (Web) agents in the same assembly, but they could also be separated into two separate assemblies. Therefore there are separate settings for TCP/IP (LUT & ODR) agents and HTTP (Web) Agents.
- Enabled/Disabling TCP/IP and HTTP Agents: the two types of agents can each be disabled or enabled e.g. if web agents are not being used in the solution they could be disabled, which will instruct the Pigeon Voice Server to not load the HTTP agent assembly at startup.
- Editing Settings: in order to updated (edit) these setting, select the setting in the grid and click the pencil icon to update the setting. Change the setting value and click the OK button.
- Saving Settings: once all the settings have been updated, click the save icon to apply the changes. N.B. changes will only be read and applied by the Pigeon Voice Server after it has been restarted. /images/manager/Pigeon-Voice-Manager-Agent-Settings.png
- Deploy Agents Library:
- We will need to copy the agent library to Pigeon Voice Server's execution (installation) directory, which by default will be: C:\Program Files (x86)\Datasmith\Pigeon Voice Server. You could do this in one of two ways:
- Manually: build the Class Library project in Visual Studio and copy the assembly (e.g. Pigeon.Voice.DemoAgentLibrary) to the above Pigeon Voice Server execution folder.
- Build Output Settings: you can modify the Class Library project's Build Output settings to automatically build the DLL to the Pigeon Voice Server's execution directory:
- Right click the project in Visual Studio, and click Properties.
- On the Build tab, change the output path to the above mentioned Pigeon Voice Server's execution directory. /images/agent-development/Pigeon-Agent-VS-Build-Settings.png
- We will need to copy the agent library to Pigeon Voice Server's execution (installation) directory, which by default will be: C:\Program Files (x86)\Datasmith\Pigeon Voice Server. You could do this in one of two ways:
- Run the Pigeon Voice Server: follow the instructions on the Running the Server page to start/restart the server as either a Windows Service or Console application. When the server starts up it will look for and load the custom agents library. Check the Pigeon Voice Server logs to see if there were any errors in loading the agent library/assembly.
