Qué agentes consultan una base de conocimiento
curl --request GET \
--url https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents \
--header 'Authorization: Bearer <token>' \
--header 'x-workspace-id: <x-workspace-id>'import requests
url = "https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents"
headers = {
"x-workspace-id": "<x-workspace-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-workspace-id': '<x-workspace-id>', Authorization: 'Bearer <token>'}
};
fetch('https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"x-workspace-id: <x-workspace-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-workspace-id", "<x-workspace-id>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents")
.header("x-workspace-id", "<x-workspace-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-workspace-id"] = '<x-workspace-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"agentId": "3f1c9c9e-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"agentName": "Cobranza MX"
},
{
"agentId": "7a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"agentName": "Soporte Voz Latam"
}
]
}Knowledge Bases
Qué agentes consultan una base de conocimiento
Antes de retirar una base, esto dice a quién le va a cambiar el comportamiento.
Una lista vacía significa que ningún agente la consulta. No significa «todos»: el vínculo es explícito, así que retirar una base no altera a agentes que nunca la nombraron.
Es sólo lectura. El vínculo se edita donde siempre se editó, publicando una versión del agente. No hay aquí una segunda forma de conectarlos.
Una base de otro workspace responde 404, no una lista vacía: la lista vacía sería
indistinguible de una base propia que nadie consulta, y de paso confirmaría que el
identificador existe en algún sitio.
GET
/
v1
/
knowledge-bases
/
{knowledgeBaseId}
/
agents
Qué agentes consultan una base de conocimiento
curl --request GET \
--url https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents \
--header 'Authorization: Bearer <token>' \
--header 'x-workspace-id: <x-workspace-id>'import requests
url = "https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents"
headers = {
"x-workspace-id": "<x-workspace-id>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'x-workspace-id': '<x-workspace-id>', Authorization: 'Bearer <token>'}
};
fetch('https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"x-workspace-id: <x-workspace-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-workspace-id", "<x-workspace-id>")
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents")
.header("x-workspace-id", "<x-workspace-id>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-prod.studio.getsupervisor.ai/v1/knowledge-bases/{knowledgeBaseId}/agents")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-workspace-id"] = '<x-workspace-id>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"agentId": "3f1c9c9e-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"agentName": "Cobranza MX"
},
{
"agentId": "7a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"agentName": "Soporte Voz Latam"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Identificador del workspace multi-tenant.
Path Parameters
Identificador de la base en Agents Studio.
Response
Los agentes que consultan la base
Vacío significa que ningún agente consulta la base. No hay paginación: un workspace tiene decenas de agentes, no miles.
Show child attributes
Show child attributes