{"id":26418190,"url":"https://github.com/beamlit/template-zendesk-ticket-analyzer","last_synced_at":"2025-03-18T01:17:17.188Z","repository":{"id":278433535,"uuid":"935582018","full_name":"beamlit/template-zendesk-ticket-analyzer","owner":"beamlit","description":"Zendesk Ticket Analysis agent built using the Blaxel SDK. The agent processes Zendesk support tickets and provides automated analysis including ticket categorization, sentiment analysis, and summary generation.","archived":false,"fork":false,"pushed_at":"2025-03-11T11:23:02.000Z","size":444,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-11T12:28:26.906Z","etag":null,"topics":["agent","langgraph","support","typescript","zendesk"],"latest_commit_sha":null,"homepage":"https://blaxel.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/beamlit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-19T17:18:22.000Z","updated_at":"2025-03-11T11:23:08.000Z","dependencies_parsed_at":"2025-02-19T19:24:38.216Z","dependency_job_id":"38671e96-0d37-44d1-843d-df23f330d89e","html_url":"https://github.com/beamlit/template-zendesk-ticket-analyzer","commit_stats":null,"previous_names":["beamlit/template-zendesk-ticket-analyzer"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beamlit%2Ftemplate-zendesk-ticket-analyzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beamlit%2Ftemplate-zendesk-ticket-analyzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beamlit%2Ftemplate-zendesk-ticket-analyzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/beamlit%2Ftemplate-zendesk-ticket-analyzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/beamlit","download_url":"https://codeload.github.com/beamlit/template-zendesk-ticket-analyzer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244135883,"owners_count":20403798,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","langgraph","support","typescript","zendesk"],"created_at":"2025-03-18T01:17:16.531Z","updated_at":"2025-03-18T01:17:17.177Z","avatar_url":"https://github.com/beamlit.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blaxel Agent - Zendesk Ticket Analyzer\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://blaxel.ai/logo.png\" alt=\"Blaxel\"/\u003e\n\u003c/p\u003e\n\nThis repository implements a Zendesk Ticket Analysis agent built using the [Blaxel SDK](https://blaxel.ai). The agent processes Zendesk support tickets and provides automated analysis including ticket categorization, sentiment analysis, and summary generation. It can analyze tickets based on their ticket numbers and provide insights such as the ticket category (technical, billing, feature, account, or general), sentiment score, and sentiment label.\n\n## How it works\n\nThe agent processes Zendesk support tickets through a streamlined analysis pipeline:\n\n1. **Ticket Retrieval**\n\n   - Uses the Zendesk API to fetch ticket details using the provided ticket number\n   - Authenticates using configured Zendesk credentials (username, API token, and URI)\n\n2. **Analysis Pipeline**\n\n   - Processes the ticket description to determine:\n     - Category classification (technical, billing, feature, account, or general)\n     - Sentiment analysis with score (-1 to 1) and label (positive, negative, or neutral)\n     - Generates a comprehensive ticket summary\n\n3. **Components**\n\n   - `ZendeskAnalyzer`: Core function that interfaces with the Zendesk API\n   - GPT-4 powered analysis for accurate categorization and sentiment detection\n   - Secure credential management through environment variables\n\n4. **Execution Flow**\n   ```\n   Ticket ID → Zendesk API → Content Analysis → Insights Generation → Response\n   ```\n\nThe agent provides a comprehensive analysis of support tickets, helping teams understand ticket context, urgency, and customer sentiment at a glance.\n\n## Prerequisites\n\n- **Node.js:** v18 or later.\n- **Blaxel CLI:** Ensure you have the Blaxel CLI installed. If not, install it globally:\n  ```bash\n  curl -fsSL https://raw.githubusercontent.com/beamlit/toolkit/main/install.sh | BINDIR=$HOME/.local/bin sh\n  ```\n- **Blaxel login:** Login to Blaxel platform\n  ```bash\n    bl login YOUR-WORKSPACE\n  ```\n\n## Installation\n\n- **Clone the repository and install the dependencies**:\n\n  ```bash\n  git clone https://github.com/beamlit/template-zendesk-ticket-analyzer.git\n  cd template-zendesk-ticket-analyzer\n  npm install\n  ```\n\n- **Environment Variables:** Create a `.env` file with your configuration. You can begin by copying the sample file:\n\n  ```bash\n  cp .env-sample .env\n  ```\n\n  Then, update the following values with your own credentials:\n\n  - Zendesk credentials: `ZENDESK_USERNAME`, `ZENDESK_API_TOKEN`, `ZENDESK_URI`\n\n- **Blaxel apply:** register your integration connection / functions / models on blaxel.ai\n\n```bash\nbl apply -R -f .blaxel\n```\n\n## Running the Server Locally\n\nStart the development server with hot reloading using the Blaxel CLI command:\n\n```bash\nbl serve --hotreload\n```\n\n_Note:_ This command starts the server and enables hot reload so that changes to the source code are automatically reflected.\n\n## Testing the agent\n\nThe server will start on port 1338. You can test the agent using the Blaxel CLI:\n\n```bash\nbl run agent my-agent --local --data '{\"inputs\":\"Can you give information about the ticket number 1234567890\"}'\nOR\nbl chat my-agent --local\n```\n\n## Deploying to Blaxel\n\nWhen you are ready to deploy your application, run:\n\n```bash\nbl deploy\n```\n\nThis command uses your code and the configuration files under the `.blaxel` directory to deploy your application.\n\n## Project Structure\n\n- **src/**\n  - `agent.ts` - Configures the chat agent, streams HTTP\n    responses, and integrates conversational context.\n  - `functions` - Directory to add your functions/tools\n    available to your agent. Documentation on how to develop your\n    own functions\n  - `config.ts` - Contains configuration and environment variable setup.\n- **.blaxel/** - Contains configuration files for Blaxel functions and models.\n- **index.ts** - The main entry point of the application.\n- **tsconfig.json** - TypeScript compiler configuration.\n- **package.json** - Lists dependencies and defines various project scripts.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeamlit%2Ftemplate-zendesk-ticket-analyzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeamlit%2Ftemplate-zendesk-ticket-analyzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeamlit%2Ftemplate-zendesk-ticket-analyzer/lists"}