API ಸಂಪರ್ಕಗಳು

ಯಾವುದೇ HTTP APIಯನ್ನು ನಿಮ್ಮ ಏಜೆಂಟ್ ಸಂಭಾಷಣೆಯ ಮಧ್ಯದಲ್ಲಿ ಕರೆಯಬಹುದಾದ ಕಾರ್ಯವಾಗಿ ಪರಿವರ್ತಿಸಿ: cURL ಆಜ್ಞೆಯನ್ನು ಅಂಟಿಸಿ, ಮತ್ತು ವಿಝಾರ್ಡ್ ಉಪಕರಣದ ವ್ಯಾಖ್ಯಾನ, ನಿಯತಾಂಕಗಳು ಮತ್ತು ದೃಢೀಕರಣವನ್ನು ನಿರ್ಮಿಸುತ್ತದೆ.

API ಸಂಪರ್ಕಗಳು ನಿಮ್ಮ ಏಜೆಂಟ್‌ಗಳು ಸಂಭಾಷಣೆಯ ವೇಳೆ ಕರೆ ಮಾಡಬಹುದಾದ ಕಸ್ಟಮ್ HTTP ಕಾರ್ಯಗಳಾಗಿವೆ — ಆರ್ಡರ್ ಹುಡುಕುವುದು, ಟಿಕೆಟ್ ರಚಿಸುವುದು, ನಿಮ್ಮ ಸ್ವಂತ ಬ್ಯಾಕೆಂಡ್‌ನಿಂದ ಖಾತೆ ಸ್ಥಿತಿಯನ್ನು ಪಡೆಯುವುದು. ನೀವು ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅನ್ನು ಒಮ್ಮೆ ಮಾತ್ರ ಸಂಪರ್ಕಗಳು → APIಗಳು (/dashboard/api-connections) ಅಡಿಯಲ್ಲಿ ವ್ಯಾಖ್ಯಾನಿಸುತ್ತೀರಿ; ಸಂಪರ್ಕವನ್ನು ಲಗತ್ತಿಸಿರುವ ಏಜೆಂಟ್‌ಗಳು ಸಂಭಾಷಣೆಯ ಅಗತ್ಯವಿದ್ದಾಗ ಅದನ್ನು ಚಾಲನೆ ಮಾಡಬಹುದು.

ಒಂದನ್ನು ನಿರ್ಮಿಸಲು ಎರಡು ಮಾರ್ಗಗಳಿವೆ: ವಿಝಾರ್ಡ್ ವಿಶ್ಲೇಷಿಸಬಹುದಾದದ್ದನ್ನು ಅಂಟಿಸುವುದು, ಅಥವಾ ಸಂಪರ್ಕವನ್ನು ಹಸ್ತಚಾಲಿತವಾಗಿ ಹೊಂದಿಸುವುದು.

ತ್ವರಿತ ಮಾರ್ಗ: ಅಂಟಿಸಿ ಮತ್ತು ವಿಶ್ಲೇಷಿಸಿ#

1. ಹೊಸ API ಸಂಪರ್ಕವನ್ನು ಕ್ಲಿಕ್ ಮಾಡಿ

   ಸಂವಾದವು ವಿಝಾರ್ಡ್‌ನಲ್ಲಿ ತೆರೆಯುತ್ತದೆ. ಬಾಕ್ಸ್‌ಗೆ ಮಾದರಿ cURL ಆಜ್ಞೆ, OpenAPI/Swagger ವಿಶೇಷಣ, Postman ಎಕ್ಸ್‌ಪೋರ್ಟ್, TypeScript ಇಂಟರ್‌ಫೇಸ್, ಅಥವಾ Zod ಸ್ಕೀಮಾ ಅನ್ನು ಅಂಟಿಸಿ.

2. ವಿಶ್ಲೇಷಿಸಿ ಕ್ಲಿಕ್ ಮಾಡಿ

   ThunderPhone ನಿಮ್ಮ ಅಂಟಿಸಿದ ಪಠ್ಯದಿಂದ ಸಂಪೂರ್ಣ ಸಂಪರ್ಕವನ್ನು ಊಹಿಸುತ್ತದೆ — URL, ವಿಧಾನ, ಹೆಡರ್‌ಗಳು, ಮತ್ತು ಅದು ಕಂಡುಕೊಂಡ ಕ್ವೆರಿ ಪ್ಯಾರಾಮೀಟರ್‌ಗಳು ಹಾಗೂ ವಿನಂತಿಯ ಬಾಡಿಯಿಂದ ಪಡೆಯಲಾದ ಪ್ಯಾರಾಮೀಟರ್ ಸ್ಕೀಮಾ. ನೀವು ಅಂಟಿಸಿದ ಹೆಡರ್‌ಗಳು (ದೃಢೀಕರಣ ಹೆಡರ್‌ಗಳು ಸೇರಿದಂತೆ) ಎಂಡ್‌ಪಾಯಿಂಟ್ ಸಂರಚನೆಗೆ ಸೇರಿಸಲಾಗುತ್ತವೆ.

3. ಎತ್ತಿತೋರಿಸಲಾದ ಕ್ಷೇತ್ರಗಳನ್ನು ದೃಢೀಕರಿಸಿ

   ಊಹಿಸಲಾದ ಸಂರಚನೆಯು ಪರಿಶೀಲನೆಗಾಗಿ ಊಹಿಸಿದ ಕ್ಷೇತ್ರಗಳನ್ನು ಎತ್ತಿತೋರಿಸಿ ತೆರೆಯುತ್ತದೆ. ಏಜೆಂಟ್ ಕಾರ್ಯವನ್ನು ಯಾವಾಗ ಮತ್ತು ಹೇಗೆ ಕರೆಯಬೇಕು ಎಂಬುದನ್ನು ಅರ್ಥಮಾಡಿಕೊಳ್ಳುವಂತೆ ಹೆಸರುಗಳು, ವಿವರಣೆಗಳು ಮತ್ತು ಪ್ಯಾರಾಮೀಟರ್ ಪ್ರಕಾರಗಳನ್ನು ಹೊಂದಿಸಿ — ವಿವರಣೆಯನ್ನೇ ಮಾದರಿ ಓದುತ್ತದೆ.

4. ಮೌಲ್ಯೀಕರಿಸಿ ಮತ್ತು ಉಳಿಸಿ

   ಉಳಿಸುವ ಮೊದಲು ನಿಮ್ಮ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ ನೇರ ಪರೀಕ್ಷಾ ವಿನಂತಿಯನ್ನು ನಡೆಸಲಾಗುತ್ತದೆ. ವಿನಂತಿ ವಿಫಲವಾದರೆ ಸಂಪರ್ಕವನ್ನು ಉಳಿಸಲಾಗುವುದಿಲ್ಲ — URL, ದೃಢೀಕರಣ ಹೆಡರ್‌ಗಳು ಅಥವಾ ಬಾಡಿಯನ್ನು ಸರಿಪಡಿಸಿ ಮತ್ತೆ ಪ್ರಯತ್ನಿಸಿ. ಯಶಸ್ವಿಯಾದರೆ ಸಂಪರ್ಕವನ್ನು ಮೌಲ್ಯೀಕರಿಸಲಾಗಿದೆ ಬ್ಯಾಡ್ಜ್‌ನೊಂದಿಗೆ ಸಂಗ್ರಹಿಸಲಾಗುತ್ತದೆ.

ನಿಮ್ಮ ಅಂಟಿಸಿದ ಪಠ್ಯದಲ್ಲಿ ವಿಝಾರ್ಡ್‌ಗೆ ವಿನಂತಿ URL ಸಿಗದಿದ್ದರೆ, ಅದು ಅದನ್ನು ತಿಳಿಸುತ್ತದೆ — ಸಂಪೂರ್ಣ http(s) ಎಂಡ್‌ಪಾಯಿಂಟ್ ಸೇರಿಸಿ ಮತ್ತೆ ಪ್ರಯತ್ನಿಸಿ.

ಹಸ್ತಚಾಲಿತ ಹೊಂದಿಕೆ#

ವಿಝಾರ್ಡ್‌ನಲ್ಲಿ ಹಸ್ತಚಾಲಿತವಾಗಿ ಹೊಂದಿಸಿ → ಕ್ಲಿಕ್ ಮಾಡಿ (ಅಥವಾ ಹಿಂದಿರುಗಲು AI ಇದನ್ನು ಊಹಿಸಬೇಕೇ? ವಿಝಾರ್ಡ್ ಪ್ರಯತ್ನಿಸಿ → ಕ್ಲಿಕ್ ಮಾಡಿ). ಹಸ್ತಚಾಲಿತ ಬಿಲ್ಡರ್‌ನಲ್ಲಿ ಎರಡು ಸಂಪಾದಕಗಳಿವೆ:

• ದೃಶ್ಯ — ಪ್ರದರ್ಶನ ಹೆಸರು, ಕಾರ್ಯದ ಹೆಸರು, ವಿನಂತಿ URL, ವಿಧಾನ (POST, GET, PUT, PATCH, DELETE), ಕಸ್ಟಮ್ ಹೆಡರ್‌ಗಳು, ಮತ್ತು ಪ್ಯಾರಾಮೀಟರ್ ಸ್ಕೀಮಾಗಾಗಿ ಫಾರ್ಮ್ ಕ್ಷೇತ್ರಗಳು (ಏಜೆಂಟ್ ಒದಗಿಸಬಹುದಾದ ಪ್ರತಿಯೊಂದು ಆರ್ಗ್ಯುಮೆಂಟ್‌ಗೆ ಗುಣಲಕ್ಷಣ ಸೇರಿಸಿ).
• JSON — ನೇರವಾಗಿ ಉಪಕರಣ ವಿಶೇಷಣವನ್ನು ಅಂಟಿಸಲು ಅಥವಾ ಸೂಕ್ಷ್ಮವಾಗಿ ಹೊಂದಿಸಲು ಮೂಲ JSON ರೂಪದಲ್ಲಿರುವ ಅದೇ ವ್ಯಾಖ್ಯಾನ.

ಐಚ್ಛಿಕವಾದ ಪರೀಕ್ಷಾ ವಿನಂತಿ ಫಲಕವು ಉಳಿಸುವ ಮೊದಲು ಸಂರಚಿತ ವಿನಂತಿಯನ್ನು ಕಳುಹಿಸಲು ಅವಕಾಶ ನೀಡುತ್ತದೆ ಮತ್ತು ಸ್ಥಿತಿ, ವಿಳಂಬ, ಹಾಗೂ ಪ್ರತಿಕ್ರಿಯೆಯ ಮುನ್ನೋಟವನ್ನು ತೋರಿಸುತ್ತದೆ. ಮೌಲ್ಯೀಕರಿಸಿ ಮತ್ತು ಉಳಿಸಿ ಯಾವಾಗಲೂ ಈ ಪರೀಕ್ಷೆಯನ್ನು ನಡೆಸುತ್ತದೆ ಮತ್ತು ಯಶಸ್ಸಾದಾಗ ಮಾತ್ರ ಉಳಿಸುತ್ತದೆ.

ನಿಮ್ಮ ಸಂಪರ್ಕಗಳನ್ನು ನಿರ್ವಹಿಸಿ#

ಪ್ರತಿ ಸಂಪರ್ಕ ಸಾಲು ಅದರ ಮೌಲ್ಯೀಕರಣ ಸ್ಥಿತಿ — ಮೌಲ್ಯೀಕರಿಸಲಾಗಿದೆ, ಪರೀಕ್ಷಿಸಲಾಗಿಲ್ಲ, ಅಥವಾ ದೋಷ — ಅದರ ಕಾರ್ಯದ ಹೆಸರು, ಮತ್ತು ಅದನ್ನು ಬಳಸುವ ಏಜೆಂಟ್‌ಗಳನ್ನು ತೋರಿಸುತ್ತದೆ. ಸಾಲಿನ ಕ್ರಿಯೆಗಳ ಮೆನುವಿನಿಂದ ನೀವು ಇವುಗಳನ್ನು ಮಾಡಬಹುದು:

• ಸಂಪಾದಿಸಿ — ಸಂರಚನೆಯನ್ನು ಮರುತೆರೆಯಿರಿ.
• ಕ್ಲೋನ್ ಮಾಡಿ — ಆರಂಭಿಕ ಬಿಂದುವಾಗಿ ಅದನ್ನು ನಕಲು ಮಾಡಿ (ನಕಲು ಪರೀಕ್ಷಿಸಲಾಗಿಲ್ಲ ಎಂಬ ಸ್ಥಿತಿಯಲ್ಲಿ ಆರಂಭವಾಗುತ್ತದೆ).
• ಪರಿಷ್ಕರಣೆ ಇತಿಹಾಸ — ಹಿಂದಿನ ಆವೃತ್ತಿಗಳನ್ನು ವೀಕ್ಷಿಸಿ ಮತ್ತು ಒಂದನ್ನು ಸಂಪಾದಕಕ್ಕೆ ಮರುಸ್ಥಾಪಿಸಿ.
• ವರ್ಗಾಯಿಸಿ — ನೀವು ಸೇರಿರುವ ಇನ್ನೊಂದು ಸಂಸ್ಥೆಗೆ ಸಂಪರ್ಕವನ್ನು ನಕಲಿಸಿ ಅಥವಾ ಸ್ಥಳಾಂತರಿಸಿ. ಸ್ಥಳಾಂತರಿಸುವುದರಿಂದ ಅದು ಇಲ್ಲಿಂದ ತೆಗೆದುಹಾಕಲ್ಪಡುತ್ತದೆ; ಅದನ್ನು ಬಳಸಿದ ಏಜೆಂಟ್‌ಗಳಿಗೆ ಮರುಸಂರಚನೆ ಬೇಕಾಗಬಹುದು.
• ಅಳಿಸಿ — ಶಾಶ್ವತ; ಸಂಪರ್ಕವನ್ನು ಬಳಸುವ ಏಜೆಂಟ್‌ಗಳನ್ನು ಮರುಸಂರಚಿಸಬೇಕು.

ಅದನ್ನು ಏಜೆಂಟ್‌ಗೆ ಲಗತ್ತಿಸಿ#

ಬಿಲ್ಡರ್‌ನ API ಸಂಪರ್ಕಗಳ ವಿಭಾಗದಲ್ಲಿ ಏಜೆಂಟ್‌ಗೆ ಸಂಪರ್ಕವನ್ನು ಸೇರಿಸಿ (ಏಜೆಂಟ್ ನಿರ್ಮಿಸಿ). ಪ್ರತಿ ಸಂಪರ್ಕವನ್ನು ಯಾವ ಏಜೆಂಟ್‌ಗಳು ಬಳಸುತ್ತವೆ ಎಂಬುದನ್ನು ಪಟ್ಟಿ ತೋರಿಸುತ್ತದೆ, ಆದ್ದರಿಂದ ಬದಲಾವಣೆಯು ಏನನ್ನು ಪ್ರಭಾವಿಸುತ್ತದೆ ಎಂಬುದನ್ನು ಒಮ್ಮೆ ನೋಡಿದಲ್ಲೇ ತಿಳಿಯಬಹುದು.

ಮುಂದಿನ ಹಂತಗಳು#