## Basic tool info Tool name: wiro/AI-Job-Description-Generator Tool description: Wiro/AI-Job-Description-Generator helps you create tailored job descriptions based on detailed job specifications. Using AI-driven analysis, effortlessly transform job details into clear, professional, and well-structured job postings. Simplify your hiring process by automating job description creation, ensuring consistency, and aligning your descriptions with industry standards. Streamline recruitment efforts with accurate, data-driven job descriptions that attract the right talent. Tool cover: https://cdn.wiro.ai/uploads/models/wiro-AI-Job-Description-Generator-cover.png Tool categories: - tool - HR - CV - resume - wiroHR - quick-showcase Tool tags: - cv analyzer - resume evaluation - cv matcher - cv score - resume analyze - hr ai - hr tools - jobdesc creator Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/wiro/AI-Job-Description-Generator Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: inputDocumentMultiple label: inputDocumentMultiple help: Can upload multiple files for additional information. Ensure the files are relevant and properly formatted for accurate processing. Supported file types: .csv, .docx, .epub, .jpeg, .jpg, .mbox, .md, .mp3, .mp4, .pdf, .png, .ppt, .pptm, .pptx type: multifileinput default: sample-cv-php-developer-english-1.pdf - name: prompt label: jobDetail help: Enter the details of the job posting, including job title, responsibilities, qualifications, and any additional information relevant to the position. Ensure the description is clear and concise to attract the right candidates. type: textarea default: We are seeking a skilled and dedicated PHP Developer to join our development team. The ideal candidate will have a strong command of PHP programming, experience with web development, and the ability to create efficient and scalable solutions. As a PHP Developer, you will play a pivotal role in designing, coding, testing, and maintaining web applications that drive our digital presence. - name: Tone label: Tone help: Please select the preferred tone for the generated job description. type: select default: Formal options: - value: "Formal" label: Formal - value: "Conversational" label: Conversational - value: "Enthusiastic" label: Enthusiastic - value: "Minimalist and Professional" label: Minimalist and Professional - value: "Creative" label: Creative - name: Language label: Language help: Please select the preferred language for the generated job description. type: select default: en options: - value: "tr" label: TR - value: "en" label: EN ## Integration Header Prepare ```bash # Sign up Wiro dashboard and create project export YOUR_API_KEY="{{useSelectedProjectAPIKey}}"; export YOUR_API_SECRET="XXXXXXXXX"; # unix time or any random integer value export NONCE=$(date +%s); # hmac-SHA256 (YOUR_API_SECRET+Nonce) with YOUR_API_KEY export SIGNATURE="$(echo -n "${YOUR_API_SECRET}${NONCE}" | openssl dgst -sha256 -hmac "${YOUR_API_KEY}")"; ``` ## Run Command - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Run/wiro/AI-Job-Description-Generator" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputDocumentMultiple": [ "sample-cv-php-developer-english-1.pdf" ], "prompt": "We are seeking a skilled and dedicated PHP Developer to join our development team. The ideal candidate will have a strong command of PHP programming, experience with web development, and the ability to create efficient and scalable solutions. As a PHP Developer, you will play a pivotal role in designing, coding, testing, and maintaining web applications that drive our digital presence.\n", "Tone": "Formal", "Language": "en", "callbackUrl": "You can provide a callback URL; Wiro will send a POST request to it when the task is completed." }'; ``` ## Run Command - Response ```json { "errors": [], "taskid": "2221", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "result": true } ``` ## Get Task Detail - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "tasktoken": 'eDcCm5yyUfIvMFspTwww49OUfgXkQt', }'; ``` ## Get Task Detail - Response ```json { "total": "1", "errors": [], "tasklist": [ { "id": "2221", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "parameters": {}, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_postprocess_end", "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Task Status Information This section defines the possible task status values returned by the API when polling for task completion. ### Completed Task Statuses (Polling can stop) These indicate that the task has reached a terminal state — either success or failure. Once any of these is received, polling should stop. - task_postprocess_end : Task completed successfully and post-processing is done. - task_cancel : Task was cancelled by the user or system. ### Running Task Statuses (Continue polling) These statuses indicate that the task is still in progress. Polling should continue if one of these is returned. - task_queue : Task is waiting in the queue. - task_accept : Task has been accepted for processing. - task_assign : Task is being assigned to a worker. - task_preprocess_start : Preprocessing is starting. - task_preprocess_end : Preprocessing is complete. - task_start : Task execution has started. - task_output : Output is being generated.