Agent:innen-Informationen abrufen
Agent:innen-Informationen abrufen
Mit der API von GPTBots können Sie grundlegende Informationen zu Ihren Agent:innen abrufen. Diese Funktion ist besonders hilfreich, wenn Sie Agenten-Informationen oder Agenten-Details für Ihre Anwendungen benötigen. Die nachfolgende Dokumentation erläutert die Vorgehensweise und die wichtigsten Parameter.
Anfragemethode
GET
Anfrage-URL
https://api-${endpoint}.gptbots.ai/v1/bot/detail
Authentifizierung der Anfrage
Weitere Informationen zur Authentifizierung finden Sie in der Übersicht.
Anfrage
Beispielanfrage
curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/bot/detail' \
-H 'Authorization: Bearer ${API Key}'
curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/bot/detail' \
-H 'Authorization: Bearer ${API Key}'
Dieser Codeblock im schwebenden Fenster
Anfrage-Header
| Feld | Typ | Beschreibung |
|---|---|---|
| Authorization | Bearer ${API Key} | Verwenden Sie Authorization: Bearer ${API Key} zur Authentifizierung. Den API-Schlüssel erhalten Sie auf der API-Key-Seite. |
Anfrageparameter
Keine Parameter erforderlich.
Antwort
Beispielantwort
{
"bot_id": "645dd86606931c4a9e0ffb1e",
"name": "Conversational App",
"logo": "https://res.gptbots.ai/ailab/images/default_avatar.png",
"bot_type": "QuestionAnswer",
"welcome_message": "Willkommensnachricht, wenn Nutzer:innen den Agent:innen zum ersten Mal verwenden",
"introduction": "Einführung der Agent:innen",
"tags": "Tags der Agent:innen",
"identity_prompt": "Identitäts-Prompt der Agent:innen",
"creativity_level": 0.3,
"doc_correlation": 0.2,
"irrelevant_questions": true,
"question_limit": 100,
"long_term_memory": true
}
{
"bot_id": "645dd86606931c4a9e0ffb1e",
"name": "Conversational App",
"logo": "https://res.gptbots.ai/ailab/images/default_avatar.png",
"bot_type": "QuestionAnswer",
"welcome_message": "Willkommensnachricht, wenn Nutzer:innen den Agent:innen zum ersten Mal verwenden",
"introduction": "Einführung der Agent:innen",
"tags": "Tags der Agent:innen",
"identity_prompt": "Identitäts-Prompt der Agent:innen",
"creativity_level": 0.3,
"doc_correlation": 0.2,
"irrelevant_questions": true,
"question_limit": 100,
"long_term_memory": true
}
Dieser Codeblock im schwebenden Fenster
Erfolgreiche Antwort
| Feld | Typ | Beschreibung |
|---|---|---|
| bot_id | string | Agent:innen-ID. |
| name | string | Name der Agent:innen. |
| logo | string | Avatar der Agent:innen. |
| bot_type | string | Typ der Agent:innen. Werte: QuestionAnswer, Flow. |
| welcome_message | string | Willkommensnachricht, wenn Nutzer:innen den Agent:innen zum ersten Mal verwenden. |
| introduction | string | Einführung der Agent:innen. |
| tags | array | Tags der Agent:innen. |
| identity_prompt | string | Identitäts-Prompt der Agent:innen. |
| creativity_level | float | Kreativitätslevel, Wert zwischen 0 und 1. |
| doc_correlation | float | Dokumentenrelevanz, Wert zwischen 0 und 1. |
| irrelevant_questions | boolean | Ob auch themenfremde Fragen beantwortet werden (Werte: true, false). |
| question_limit | int | Begrenzung der Token-Länge für Fragen von Nutzer:innen. |
| long_term_memory | boolean | Ob das Langzeitgedächtnis aktiviert ist. |
Fehlermeldung
| Feld | Typ | Beschreibung |
|---|---|---|
| code | int | Fehlercode. |
| message | string | Fehlerdetails. |
Fehlercodes
| Code | Nachricht |
|---|---|
| 40127 | Entwickler:innen-Authentifizierung fehlgeschlagen (Authentifizierungsfehler) |
| 20059 | Agent:in gelöscht |
SEO-Hinweis:
Diese Seite nutzt relevante Keywords wie „API Dokumentation“, „Agenten Informationen abrufen“ und „GPTBots API“, um die Auffindbarkeit für technische Entscheider:innen und Entwickler:innen zu verbessern.
Weiterführende Aktionen:
- [Demo buchen]
- [Mehr erfahren]
