Как вызвать агента через API

Как вызывать агента через API

Платформа AgentsWorks.ru предоставляет возможность вызывать ваших ИИ агентов из внешних сервисов, таких как Telegram боты, веб-приложения или другие системы, используя API. Это позволяет интегрировать функциональность вашего агента в различные сценарии использования.

Шаг 1: Получение API ключа

Для начала вам потребуется сгенерировать API ключ. Это уникальный идентификатор, который будет использоваться для аутентификации ваших запросов к API.

1. Войдите в свой аккаунт на AgentsWorks.ru.
2. Перейдите в раздел "Настройки".

3. В меню настроек выберите "Управление данными".

4. Найдите секцию "Agent API Keys" и нажмите кнопку "Управление".

5. Нажмите "Create API Key" для создания нового ключа. Скопируйте его и сохраните в безопасном месте. Этот ключ будет использоваться для всех ваших API запросов.

Шаг 2: Вызов агента через API

После получения API ключа вы можете отправлять запросы к API AgentsWorks.ru. Основной метод для взаимодействия с агентом — это отправка POST-запроса на https://agentsworks.ru/api/agents/v1/chat/completions.

Запрос

curl -X POST https://agentsworks.ru/api/agents/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "YOUR_AGENT_ID,
  "messages": [{"role": "user", "content": "Текст вашего запроса"}],
  "agent_id": "YOUR_AGENT_ID",
  "stream": false
}'

Пояснения:

• YOUR_API_KEY: Замените на ваш сгенерированный API ключ из шага 1.
• YOUR_AGENT_ID: Идентификатор вашего агента. Его можно найти в URL страницы агента или в его настройках.

Пример запроса:

curl -X POST https://agentsworks.ru/api/agents/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "agent_9DKRUYUuF68MPNmn016Wx",
  "messages": [{"role": "user", "content": "Реши уравнение X^2+4x+1=0"}],
  "agent_id": "agent_9DKRUYUuF68MPNmn016Wx",
  "stream": false
}'

Шаг 3: Обработка ответа

API вернет JSON-объект, содержащий ответ от вашего агента. Вам нужно будет разобрать этот JSON и извлечь необходимую информацию.

Пример ответа (JSON):

{
  "id": "chatcmpl-5NRjH8H7pfdOvwzYxqaNu",
  "object": "chat.completion",
  "created": 1773074790,
  "model": "agent_9DKRUYUuF68MPNmn016Wx",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Привет! Я вижу, ты хочешь решить квадратное уравнение. Отлично!\n\nПрежде чем я помогу тебе, скажи, пожалуйста, каким методом ты бы хотел его решить? Например, можно использовать формулу дискриминанта, выделить полный квадрат или попробовать что-то еще.\n\nИли, если ты уже пробовал решать, покажи мне свое решение, и я проверю его и дам обратную связь."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 1271,
    "completion_tokens": 89,
    "total_tokens": 1360
  }
}

Интеграция с Telegram ботом

Для интеграции с Telegram ботом вы можете использовать любую библиотеку для работы с Telegram Bot API (например, python-telegram-bot для Python). Логика будет следующей:

1. Пользователь отправляет сообщение вашему Telegram боту.
2. Бот принимает сообщение и формирует из него запрос к API AgentsWorks.ru.
3. Бот отправляет POST-запрос к API AgentsWorks.ru, используя ваш API ключ и ID агента.
4. Получив ответ от AgentsWorks.ru, бот извлекает response и отправляет его обратно пользователю в Telegram.

Важные замечания:

• Безопасность: Храните ваш API ключ в безопасности и не раскрывайте его публично.
• Лимиты: Учитывайте возможные лимиты на количество запросов к API.
• Обработка ошибок: Реализуйте обработку ошибок в вашем коде для корректной реакции на возможные проблемы с API (например, неверный ключ, недоступность сервиса и т.д.).

Следуя этой инструкции, вы сможете успешно интегрировать ваших ИИ агентов с AgentsWorks.ru в любые внешние сервисы.