MCP Tools Reference: ces.googleapis.com

Tool: list_agents

Listet Agenten in der angegebenen App auf.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool list_agents aufrufen.

Curl-Anfrage 
                  
curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_agents",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Eingabeschema

Anfragenachricht für AgentService.ListAgents.

ListAgentsRequest

JSON-Darstellung 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string,
  "filter": string,
  "orderBy": string
}
Felder
parent

string

Erforderlich. Der Ressourcenname der App, aus der Agents aufgelistet werden sollen.
pageSize

integer

Optional. Angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente als angefordert zurück. Wenn kein Wert angegeben wurde, wählt der Server einen geeigneten Standardwert aus.
pageToken

string

Optional. Der Wert next_page_token wurde gegebenenfalls von einem vorherigen AgentService.ListAgents-Listenaufruf zurückgegeben.
filter

string

Optional. Filter, der beim Auflisten der Agents angewendet werden soll. Weitere Informationen finden Sie unter https://google.aip.dev/160.
orderBy

string

Optional. Feld, nach dem sortiert werden soll. Nur „name“ und „create_time“ werden unterstützt. Weitere Informationen finden Sie unter https://google.aip.dev/132#ordering.

Ausgabeschema

Antwortnachricht für AgentService.ListAgents.

ListAgentsResponse

JSON-Darstellung 
{
  "agents": [
    {
      object (Agent)
    }
  ],
  "nextPageToken": string
}
Felder
agents[]

object (Agent)

Die Liste der Agents.
nextPageToken

string

Ein Token, das als ListAgentsRequest.page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld fehlt, gibt es keine nachfolgenden Seiten.

Agent

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "description": string,
  "modelSettings": {
    object (ModelSettings)
  },
  "instruction": string,
  "tools": [
    string
  ],
  "childAgents": [
    string
  ],
  "beforeAgentCallbacks": [
    {
      object (Callback)
    }
  ],
  "afterAgentCallbacks": [
    {
      object (Callback)
    }
  ],
  "beforeModelCallbacks": [
    {
      object (Callback)
    }
  ],
  "afterModelCallbacks": [
    {
      object (Callback)
    }
  ],
  "beforeToolCallbacks": [
    {
      object (Callback)
    }
  ],
  "afterToolCallbacks": [
    {
      object (Callback)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "guardrails": [
    string
  ],
  "etag": string,
  "toolsets": [
    {
      object (AgentToolset)
    }
  ],
  "generatedSummary": string,
  "transferRules": [
    {
      object (TransferRule)
    }
  ],

  // Union field agent_type can be only one of the following:
  "llmAgent": {
    object (LlmAgent)
  },
  "remoteDialogflowAgent": {
    object (RemoteDialogflowAgent)
  }
  // End of list of possible types for union field agent_type.
}
Felder
name

string

ID. Die eindeutige ID des Agents. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
displayName

string

Erforderlich. Anzeigename des KI-Agenten.
description

string

Optional. Eine menschenlesbare Beschreibung des KI-Agenten.
modelSettings

object (ModelSettings)

Optional. Konfigurationen für das LLM-Modell.
instruction

string

Optional. Anweisungen für das LLM-Modell, um das Verhalten des Agents zu steuern.
tools[]

string

Optional. Liste der verfügbaren Tools für den Agenten. Format: projects/{project}/locations/{location}/apps/{app}/tools/{tool}
childAgents[]

string

Optional. Liste der untergeordneten Agents in der Agent-Baumstruktur. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
beforeAgentCallbacks[]

object (Callback)

Optional. Die Rückrufe, die vor dem Aufrufen des Agents ausgeführt werden sollen. Die bereitgestellten Callbacks werden nacheinander in der Reihenfolge ausgeführt, in der sie in der Liste angegeben sind. Wenn ein Callback eine überschriebene Antwort zurückgibt, wird die Ausführung beendet und alle verbleibenden Callbacks werden übersprungen.
afterAgentCallbacks[]

object (Callback)

Optional. Die Callbacks, die nach dem Aufrufen des Agenten ausgeführt werden sollen. Die bereitgestellten Callbacks werden nacheinander in der Reihenfolge ausgeführt, in der sie in der Liste angegeben sind. Wenn ein Callback eine überschriebene Antwort zurückgibt, wird die Ausführung beendet und alle verbleibenden Callbacks werden übersprungen.
beforeModelCallbacks[]

object (Callback)

Optional. Die Callbacks, die vor dem Aufrufen des Modells ausgeführt werden sollen. Wenn das Modell mehrmals aufgerufen wird, wird der Callback mehrmals ausgeführt. Die bereitgestellten Callbacks werden nacheinander in der Reihenfolge ausgeführt, in der sie in der Liste angegeben sind. Wenn ein Callback eine überschriebene Antwort zurückgibt, wird die Ausführung beendet und alle verbleibenden Callbacks werden übersprungen.
afterModelCallbacks[]

object (Callback)

Optional. Die Callbacks, die nach dem Aufrufen des Modells ausgeführt werden sollen. Wenn das Modell mehrmals aufgerufen wird, wird der Callback mehrmals ausgeführt. Die bereitgestellten Callbacks werden nacheinander in der Reihenfolge ausgeführt, in der sie in der Liste angegeben sind. Wenn ein Callback eine überschriebene Antwort zurückgibt, wird die Ausführung beendet und alle verbleibenden Callbacks werden übersprungen.
beforeToolCallbacks[]

object (Callback)

Optional. Die Callbacks, die vor dem Aufrufen des Tools ausgeführt werden sollen. Wenn mehrere Tool-Aufrufe vorhanden sind, wird der Callback mehrmals ausgeführt. Die bereitgestellten Callbacks werden nacheinander in der Reihenfolge ausgeführt, in der sie in der Liste angegeben sind. Wenn ein Callback eine überschriebene Antwort zurückgibt, wird die Ausführung beendet und alle verbleibenden Callbacks werden übersprungen.
afterToolCallbacks[]

object (Callback)

Optional. Die Callbacks, die nach dem Aufrufen des Tools ausgeführt werden sollen. Wenn mehrere Tool-Aufrufe vorhanden sind, wird der Callback mehrmals ausgeführt. Die bereitgestellten Callbacks werden nacheinander in der Reihenfolge ausgeführt, in der sie in der Liste angegeben sind. Wenn ein Callback eine überschriebene Antwort zurückgibt, wird die Ausführung beendet und alle verbleibenden Callbacks werden übersprungen.
createTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel für die Erstellung des KI-Agents.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel der letzten Aktualisierung des KI-Agents.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
guardrails[]

string

Optional. Liste der Schutzmaßnahmen für den Agent. Format: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}
etag

string

Etag, das verwendet wird, um sicherzustellen, dass sich das Objekt während eines Read-Modify-Write-Vorgangs nicht geändert hat. Wenn das ETag leer ist, werden alle gleichzeitigen Änderungen durch das Update überschrieben.
toolsets[]

object (AgentToolset)

Optional. Liste der Toolsets für den Agenten.
generatedSummary

string

Nur Ausgabe. Wenn der Agent vom LLM-Assistenten generiert wird, enthält dieses Feld eine beschreibende Zusammenfassung der Generierung.
transferRules[]

object (TransferRule)

Optional. Regeln für die Agent-Übertragung. Wenn mehrere Regeln übereinstimmen, wird die erste Regel in der Liste verwendet.
Union-Feld agent_type. Der Typ des Agents. Für agent_type ist nur einer der folgenden Werte zulässig:
llmAgent

object (LlmAgent)

Optional. Der Standard-KI-Agententyp.
remoteDialogflowAgent

object (RemoteDialogflowAgent)

Optional. Der Remote-Dialogflow-Agent, der für die Ausführung des Agent verwendet werden soll. Wenn dieses Feld festgelegt ist, werden alle anderen Eigenschaften auf Agentenebene ignoriert.

Hinweis: Wenn sich der Dialogflow-Agent in einem anderen Projekt als die App befindet, sollten Sie dem CES-Dienst-Agent service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com die Rolle roles/dialogflow.client zuweisen.

RemoteDialogflowAgent

JSON-Darstellung 
{
  "agent": string,
  "flowId": string,
  "environmentId": string,
  "inputVariableMapping": {
    string: string,
    ...
  },
  "outputVariableMapping": {
    string: string,
    ...
  },
  "respectResponseInterruptionSettings": boolean
}
Felder
agent

string

Erforderlich. Der Ressourcenname des Dialogflow-KI-Agenten. Format: projects/{project}/locations/{location}/agents/{agent}
flowId

string

Optional. Die Ablauf-ID des Ablaufs im Dialogflow-Agent.
environmentId

string

Optional. Die Umgebungs-ID des Dialogflow-Agents, der für die Agent-Ausführung verwendet werden soll. Wenn keine Angabe erfolgt, wird die Umgebung „Entwurf“ verwendet.
inputVariableMapping

map (key: string, value: string)

Optional. Die Zuordnung der Namen der App-Variablen zu den Namen der Dialogflow-Sitzungsparameter, die als Eingabe an den Dialogflow-Agent gesendet werden sollen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
outputVariableMapping

map (key: string, value: string)

Optional. Die Zuordnung der Namen der Dialogflow-Sitzungsparameter zu den Namen der App-Variablen, die nach Abschluss der Ausführung des Dialogflow-Agenten an den CES-Agenten zurückgesendet werden sollen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
respectResponseInterruptionSettings

boolean

Optional. Gibt an, ob die auf Nachrichtenebene konfigurierten Unterbrechungseinstellungen im Dialogflow-Agent berücksichtigt werden sollen.

  • Bei „false“: Alle Antwortnachrichten des Dialogflow-Agents folgen den Barge-in-Einstellungen auf App-Ebene.
  • Wenn „true“: Nur Antwortnachrichten, bei denen allow_playback_interruption auf „true“ gesetzt ist, können unterbrochen werden. Für alle anderen Nachrichten gelten die Einstellungen für das Unterbrechen auf App-Ebene.

InputVariableMappingEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

OutputVariableMappingEntry

JSON-Darstellung 
{
  "key": string,
  "value": string
}
Felder
key

string
value

string

ModelSettings

JSON-Darstellung 
{
  "model": string,

  // Union field _temperature can be only one of the following:
  "temperature": number
  // End of list of possible types for union field _temperature.
}
Felder
model

string

Optional. Das LLM-Modell, das der Agent verwenden soll. Wenn nicht festgelegt, übernimmt der Agent das Modell vom übergeordneten Agent.

Union-Feld _temperature.

Für _temperature ist nur einer der folgenden Werte zulässig:
temperature

number

Optional. Wenn festgelegt, wird diese Temperatur für das LLM-Modell verwendet. Die Temperatur steuert die Zufälligkeit der Antworten des Modells. Niedrigere Temperaturen führen zu vorhersagbareren Antworten. Höhere Temperaturen führen zu kreativeren Antworten.

Rückruf

JSON-Darstellung 
{
  "description": string,
  "disabled": boolean,
  "proactiveExecutionEnabled": boolean,

  // Union field callback can be only one of the following:
  "pythonCode": string
  // End of list of possible types for union field callback.
}
Felder
description

string

Optional. Eine menschenlesbare Beschreibung des Rückrufs.
disabled

boolean

Optional. Gibt an, ob der Rückruf deaktiviert ist. Deaktivierte Rückrufe werden vom Kundenservicemitarbeiter ignoriert.
proactiveExecutionEnabled

boolean

Optional. Wenn aktiviert, wird der Callback auch für Zwischenausgaben des Modells ausgeführt. Diese Einstellung wirkt sich nur auf den After-Model-Callback aus. MIT VORSICHT AKTIVIEREN. Normalerweise muss „after_model_callback“ erst nach dem Empfang aller Modellantworten ausgeführt werden. Die Aktivierung der proaktiven Ausführung kann sich negativ auf die Ausführungskosten und die Latenz auswirken und sollte nur in seltenen Fällen aktiviert werden.
Union-Feld callback. Der auszuführende Callback. Für callback ist nur einer der folgenden Werte zulässig:
pythonCode

string

Erforderlich. Der Python-Code, der für den Callback ausgeführt werden soll.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen.

AgentToolset

JSON-Darstellung 
{
  "toolset": string,
  "toolIds": [
    string
  ]
}
Felder
toolset

string

Erforderlich. Der Ressourcenname des Toolsets. Format: projects/{project}/locations/{location}/apps/{app}/toolsets/{toolset}
toolIds[]

string

Optional. Die Tool-IDs zum Filtern des Toolsets.

TransferRule

JSON-Darstellung 
{
  "childAgent": string,
  "direction": enum (Direction),

  // Union field rule_type can be only one of the following:
  "deterministicTransfer": {
    object (DeterministicTransfer)
  },
  "disablePlannerTransfer": {
    object (DisablePlannerTransfer)
  }
  // End of list of possible types for union field rule_type.
}
Felder
childAgent

string

Erforderlich. Der Ressourcenname des untergeordneten Agenten, für den die Regel gilt. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
direction

enum (Direction)

Erforderlich. Die Richtung der Übertragung.
Union-Feld rule_type. Der Regeltyp. Für rule_type ist nur einer der folgenden Werte zulässig:
deterministicTransfer

object (DeterministicTransfer)

Optional. Eine Regel, die sofort an den Ziel-Agent übertragen wird, wenn die Bedingung erfüllt ist.
disablePlannerTransfer

object (DisablePlannerTransfer)

Optional. Regel, die verhindert, dass der Planner an den Ziel-Kundenservicemitarbeiter weitergeleitet wird.

DeterministicTransfer

JSON-Darstellung 
{

  // Union field condition_type can be only one of the following:
  "expressionCondition": {
    object (ExpressionCondition)
  },
  "pythonCodeCondition": {
    object (PythonCodeCondition)
  }
  // End of list of possible types for union field condition_type.
}
Felder
Union-Feld condition_type. Die auszuwertende Bedingung. Für condition_type ist nur einer der folgenden Werte zulässig:
expressionCondition

object (ExpressionCondition)

Optional. Eine Regel, die eine Bedingung für den Sitzungsstatus auswertet. Wenn die Bedingung als „true“ ausgewertet wird, erfolgt die Übertragung.
pythonCodeCondition

object (PythonCodeCondition)

Optional. Eine Regel, in der ein Python-Codeblock verwendet wird, um die Bedingungen auszuwerten. Wenn die Bedingung als „true“ ausgewertet wird, erfolgt die Übertragung.

ExpressionCondition

JSON-Darstellung 
{
  "expression": string
}
Felder
expression

string

Erforderlich. Die Stringdarstellung der Bedingung „cloud.api.Expression“.

PythonCodeCondition

JSON-Darstellung 
{
  "pythonCode": string
}
Felder
pythonCode

string

Erforderlich. Der auszuführende Python-Code.

DisablePlannerTransfer

JSON-Darstellung 
{
  "expressionCondition": {
    object (ExpressionCondition)
  }
}
Felder
expressionCondition

object (ExpressionCondition)

Erforderlich. Wenn die Bedingung als „true“ ausgewertet wird, darf der Planer nicht zum Ziel-Kundenservicemitarbeiter weitergeleitet werden.

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌