通常、エージェントの作成と削除はコンソールを使用して行います。ただし、特定の高度なシナリオでは、API を使用する方が簡単な場合もあります。
エージェントを作成する
次の例では、Agent
型の Create
メソッドを呼び出す方法を示します。
エージェント リファレンスのプロトコルとバージョンを選択:
プロトコル | V3 | V3beta1 |
---|---|---|
REST | エージェント リソース | エージェント リソース |
RPC | エージェント インターフェース | エージェント インターフェース |
C++ | AgentsClient | 利用できません |
C# | AgentsClient | 利用できません |
Go | AgentsClient | 利用できません |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | 利用不可 | 利用できません |
Python | AgentsClient | AgentsClient |
Ruby | 利用不可 | 利用できません |
REST
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: 実際の Google Cloud プロジェクト ID
- REGION_ID: リージョン ID
HTTP メソッドと URL:
POST https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents
リクエストの本文(JSON):
{ "displayName": "My display name", "defaultLanguageCode": "en", "timeZone": "America/New_York" }
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{ "name": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID", "displayName": "My display name", "defaultLanguageCode": "en", "timeZone": "America/New_York", "startFlow": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/flows/00000000-0000-0000-0000-000000000000", "advancedSettings": { "loggingSettings": {} } }
Java
Dialogflow への認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証の設定をご覧ください。
Node.js
Dialogflow への認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証の設定をご覧ください。
Python
Dialogflow への認証を行うには、アプリケーションのデフォルト認証情報を設定します。詳細については、ローカル開発環境の認証の設定をご覧ください。
エージェントを削除する
次の例では、Agent
型の Delete
メソッドを呼び出す方法を示します。
エージェント リファレンスのプロトコルとバージョンを選択:
プロトコル | V3 | V3beta1 |
---|---|---|
REST | エージェント リソース | エージェント リソース |
RPC | エージェント インターフェース | エージェント インターフェース |
C++ | AgentsClient | 利用できません |
C# | AgentsClient | 利用できません |
Go | AgentsClient | 利用できません |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | 利用不可 | 利用できません |
Python | AgentsClient | AgentsClient |
Ruby | 利用不可 | 利用できません |
REST
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: 実際の Google Cloud プロジェクト ID
- REGION_ID: リージョン ID
- AGENT_ID: エージェント作成レスポンスに含まれるエージェント ID
HTTP メソッドと URL:
DELETE https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID
リクエストを送信するには、次のいずれかのオプションを展開します。
成功したことを示すステータス コード(2xx)と空のレスポンスが返されます。