Create Agentforce Topic
sf_create_agent_topicIdempotent
Create an Agentforce agent topic to define request scope and attach the action APIs it should execute. Must be called after creating actions and before creating the agent planner.
Instructions
Creates a Topic (GenAiPlugin) for an Agentforce Agent — step 3 of the agent setup sequence. Call this AFTER all actions have been created with sf_create_agent_action. CRITICAL: pass ALL action API names in the 'actions' array — omitting it creates a topic with no executable actions and the agent silently does nothing. agentName is informational only (not written to XML) — the actual agent→topic wiring happens in sf_create_agent_planner which you MUST call immediately after this step. Do not stop between steps.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | Topic label | |
| scope | Yes | Scope of this topic — what kind of requests it handles | |
| actions | No | CRITICAL: Action API names (from sf_create_agent_action) to link to this topic. If you omit this or pass an empty array, the topic is created with NO executable actions — the agent will silently do nothing for this topic. Always include all action API names here. | |
| agentName | Yes | Parent agent API name — informational only, NOT written to the topic XML. The actual agent→topic wiring happens in sf_create_agent_planner (required separate step). | |
| topicName | Yes | Topic API name, e.g. 'OrderManagement'. Letters, numbers, underscores. This is the name you must include in topicNames when calling sf_create_agent_planner. | |
| description | Yes | What this topic covers | |
| instructions | No | Step-by-step instructions for handling this topic. Pass as a single string or an array of strings (each becomes a separate instruction entry). |